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PREFACE 



This manual enables the user to employ the TX990 Operating System, in its standardized or 
customized modular configuration (including associated utility programs), with the user's 
standardized or customized hardware configuration. 

The sections and appendixes of this manual are organized as follows: 

I General Description - Provides a general description of the TX990 Operating System and 
its utility programs. 

II Loading the Operating System - Provides several alternative step-by-step procedures for 
loading the Operating System. 

HI Operator Communication Package (OCP) - Describes the keyboard commands available 
to the operator for communicating interactively with the TX990 Operating System (e.g., 
to load a program, abort a task, abort an I/O operation, debug a program, set and clear 
breakpoints, et al). 

IV Control Program - Describes how to use the Control Program to load and execute program 
from the console. 

V Programming Tasks - Describes how to program user tasks to run under TX990. 

VI Executive Supervisor Calls — Describes how the user can employ the executive manage- 
ment capability of the Operating System through programmed supervisor calls. 

VII Device and File I/O Supervisor Calls — Describes how the user can employ the executive 
management capability of the Operating System for controlling an input/output device or 
file. 

VIII Diskette OCP System Utility (SYSUTL) Program - Describes the keyboard commands 
available to the operator for communicating interactively with diskette devices and files. 

IX System Generation (GENTX) Utility Program — Describes how the user can customize an 
operating system for a specific hardware and software configuration. 

X Diskette/Disc Backup and Initialize (BACKUP) Utility Program - Describes how to copy 
(or backup) and verify diskettes, as well as initialize new diskettes. 

XI Object Manager (OBJMGR) Utility Program — Describes how to copy standard and 
compressed object modules from diskette-, cassette-, or card-files onto diskette or cassette 
files and how to organize the files by deleting or adding modules. 

XII LIST80/80 (LIST 80) Utility Program - Describes how to copy 80-character records 
from one device or file to another. 

XIII Diskette Dump (DSKDMP) Utility Program — Describes how the user can load, display, 
and modify diskettes on an allocation unit basis. 
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A List of Supervisor Calls - Provides a list of all the TX990 Operating System supervisor 
calls. 

B Device Character Sets - Lists the character sets for the 91 1 VDT, 913 VDT, 733 or 743 
Data Terminal, 804 Card Reader, 306, 2230, 2260 and 588 Line Printers, 33 ASR 
Teletypewriter. 

C User-Supplied Modules - Describes user-supplied software modules that may be required 
for unique peripheral devices, user's extended operations, or user supervisor calls. 

D Glossary' - Clarifies selected words used in this TX990 Operating System Programmer's 
Guide. 

E TX990-DX10 Compatibility - Describes the considerations to be met to achieve upward 
compatibility of tasks from the TX990 Operating System to the DX10 Operating System. 

F Compressed Object Code Format — Describes the compressed object code format. 

G Task State Codes — Lists and describes the task state codes. 

H Printout of Fatal Task Error Codes or Display of Illegal Interrupt Code — Lists and 
describes the fatal task error codes and the illegal interrupt code. 

I I/O Error Codes — Lists and describes the I/O error codes available to the user, when 
coding a program, for printout or display on a terminal device. 

J System Tasks - Describes the eight system tasks capable of being included in the TX990 
Operating System. 

K System Generation using DX10 Release 3.0 - Steps involved in TX990 system generation 
on aDXIO system. 

L Support for the 32 I/O Module — Describes the I/O supervisor call and system generation 
support for the 32 I/O module supported by TX990 as a special device. 

M Support for the 5MT/6MT Module — Describes the I/O supervisor call and system 
generation support for the 5MT/6MT special device supported by TX990. 

The following documents contain additional information related to the TX990 Operating System 
and are referenced herein this manual: 

Title Part Number 

Model 990 Computer Terminal Executive Development 94625 8 -970 1 

System (TXDS) Programmer's Guide 

Model 990 Computer TMS9900 Microprocessor Assembly 94344 1 -970 1 

Language Programmer's Guide 

Model 990 Computer Model FD800 Floppy Disc System 945253-9701 

Installation and Operation 
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Title Part Number 

Model 990 Computer Model 913 CRT Display Terminal 943457-9701 

Installation and Operation 

Model 990 Computer Model 91 1 Video Display Terminal 945423-970 1 

Installation and Operation 

Model 990 Computer Model 733 ASR/KSR Data 945259-970 1 

Terminal Installation and Operation 

Model 990 Computer Model 804 Card Reader Installation 945262-9701 

and Operation 

Model 990 Computer Models 306 and 588 Line Printers 94526 1 -970 1 

Installation and Operation 

Model 990 Computer PROM Programming Module 945258-9701 

Installation and Operation 

990 Computer Family Systems Handbook 945250-970 1 

Model 990 Computer Communications Systems 945 409-970 1 

Installation and Operation 

Model 990 Computer DX10 Operating System 945257-9701 

Programmer's Guide 

Model 990 Computer Communications 946236-970 1 

System Software 
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SECTION I 
GENERAL DESCRIPTION 



1.1 OVERVIEW 

The TX990 operating system is an executive that controls task execution in a real time 
environment. TX990 executes in either the Model 990/4 or the Model 990/10 Computer. The 
memory protect Hardware option (JV±odei 990/4) anu memory mapping option (Modei 990/10) are 
not used by TX990. The maximum memory size is 56K bytes in the Model 990/4 Computer and 
62K bytes in the Model 990/10 Computer. 

TX990 may be customized to provide many features for the user, and configured to save memory 
by excluding features which are not desired. A minimum TX990 system includes a task scheduler, 
interrupt handler for the clock, and a supervisor call interface, and occupies about 4K bytes of 
memory. Additional modules and features (e.g., file management, operator communications 
package) are optional according to application requirements. 

The task scheduler provides multiple priority level scheduling of Central Processor Unit (CPU) time 
and maintains a list of active tasks at each priority level. Four levels of priority are available for user 
tasks. The TX990 Operating System allocates time to tasks by time slicing. Tasks are allocated time 
slices at each of the four priority levels on a first-in, first-out (FIFO) basis. During system 
generation the user may specify the maximum number of time slices that may occur at each priority 
level before giving the next priority level a time slice. The length of time slice is also specified during 

c\/et£*m apnprolir\n 

The interrupt handling software operates in conjunction with the prioritized interrupt scheme to 
allow the user to assign high interrupt priorities to critical devices or input lines. The interrupt 
handler must be included in the operating system to support clock-interrupt time slicing and 
time-dependent supervisor calls. 

Tasks request the support of the operating system by executing supervisor calls (SVCs). SVCs are 
routed through a supervisor call interface to an associated supervisor call processor. A substantial 
number of file management supervisor calls and task control calls are supported by the operating 
system. The user may also include his own custom supervisor call processors if desired. 

Tasks that execute under TX990 may be classified as either dynamic tasks or tasks linked into the 
operating system. When a TX990 operating system is generated, its various parts must be link edited 
to form a single linked object module, which can be loaded into memory and executed as an 
operating system. Any system or user tasks linked with the other system modules are loaded into 
memory when the system is booted, and are memory resident. 

Other tasks, called dynamic tasks, that are not linked with the system may reside in diskette files or 
cassettes. They may be dynamically loaded and executed through the use of operator commands or 
supervisor calls. All user tasks not linked in with the system are dynamic tasks. Dynamic tasks are 
loaded beyond the end of the operating system and all linked-in tasks, into memory called the 
dynamic task area. The TX990 operating system may be customized to support a single dynamic 
task, multiple dynamic tasks, or no dynamic tasks. 
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1.2 SUPPORTED HARDWARE 

The Model 990 Computer System hardware supported by TX990 include the following: 

Model 990/4 or 990/10 Computer 

Programmer Panel 

FD800 Floppy Disk 

Model 911 or 9 1 3 Video Display Terminal 

Model 733 "Silent 700"* ASR/KSR Data Terminal 

Model 743 Data Terminal 

Model 306 Line Printer 

Model 588 Line Printer 

Model 810 Line Printer 

Model 2230 Line Printer 

Model 2260 Line Printer 

Model 804 Card Reader 

33 ASR Teletype Data Terminal 

5MT/6MT Serial Interface Module 

32-In/Transition Detection Module 

1 .3 FILE MANAGEMENT FEATURES 

The TX990 operating system optionally provides a file management package to support file 
structures and operations on diskettes and file-oriented devices. File management maintains a 
directory on all initialized diskettes in the system (see Section X on diskette initialization). This 
directory can point to up to 48 files on the diskette. Diskette files consist of blocks of allocation 
units. An allocation unit is a logical division of the diskette. A diskette is divided into 333 allocation 
units, each consisting of six sectors. Two basic file types are supported: sequential files and relative 
record files. Additionally, a special usage of the relative record file, called a program file, is 
supported. Some of the features of the file management package and file types are described in the 
following paragraphs. 

1.3.1 VOLUME NAMES. In addition to accessing files on a particular diskette drive (e.g., DSC, 
DSC2), file management optionally supports volume names for initialized diskettes. When a diskette 
is initialized, the user may assign it a one to four character volume name. If volume name support is 
included in the operating system, files on that diskette may be accessed through the volume name 
or the diskette drive device name. Addressing a diskette by volume name can be performed 
regardless of which drive it may be mounted on. 

♦Trademark of Texas Instruments Incorporated 
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Volume names are only supported by operating systems which include the module VOLUME (see 
the section on system generation). The standard TI supplied TX990 operating systems do not 
provide volume name support and diskettes may only be accessed by drive name. 

1.3.2 SEQUENTIAL FILES. The logical data records in a sequential record file must be accessed 
in a sequential manner (i.e., record 1 must be processed before record 2, etc.). When a sequential 
file is closed following an access, the operating system saves the position of the last access to the 
file. When the file is opened again, the next I/O call accesses the next logical record in the file 
instead of the first logical record of the file. To access the first logical record, the file must be 
rewound before the access. 

The last write operation performed on a file defines the current end of that file. No data can be read 
from the media that is beyond the current end of that file. The operating system prevents switching 
from a read, backspace or forward space operation to a write or write end-of-file operation until an 
end-of-file mark is read; however, when extending a file, a backspace of one record can be followed 
by write operations. This precaution prevents writing on data previously stored in a file. Similarly, 
the operating system prevents switching from a write operation to a read, forward space, backspace, 
or rewind operation until an end-of-file mark is written. 

Sequential files are blank compressed: i.e., when a logical record is written to a file, ASCII blanks 
are removed from the record. Blanks are restored to the record as it is read from the file. 

1.3.2.1 Sequential Cassette File. A cassette may contain a single file that fills one side of the 
cassette, or it may contain multiple subfiles with an end-of-file mark separating each individual file. 
The beginning of the first file on the tape is located by executing a rewind operation. Subsequent 
subfiles can be located by forward spacing or reading to the next end-of-file mark. Any number of 
suuiiies may appear on tue cassette; however, the length of the file is limited to one side of the 
cassette. 

1.3.2.2 Sequential Diskette File. A sequential diskette file is comprised of logical records in blocks 
of allocation units. Whenever possible, the operating system will allocate contiguous blocks of 
allocation units. Diskette files may be created by either the Create File operation (code 90 16 ), or 
through the autocreate function when the file is opened. The operating system allocates additional 
allocation units to the file as needed when writing to the file. Each diskette file can contain a 
maximum of 20 noncontiguous blocks. Each file is terminated by an end-of-file mark. The 
beginning of the file can be located by executing a rewind file operation. Subfiles can be created by 
inserting end-of-file marks within the file. To add a new record to the end of a existing file or last 
subfile, read (or forward space) until the end-of-file mark is detected. Then backspace one record to 
position the media on the end-of-file record and write the new record(s). 

1.3.3 RELATIVE RECORD FILES. Relative record files are supported only on diskette. A relative 
record file is comprised of contiguous and noncontiguous blocks of logical records, in or out of 
sequence (i.e., in random sequence). Each logical record is identified by a logical record number. 
Space is automatically allocated for a relative record file in blocks of contiguous allocation units 
when possible and, when not possible, in blocks of noncontiguous allocation units. There is no 
maximum number of logical records which can be placed in the file. However, there can be no more 
than 20 noncontiguous blocks of allocation units. The beginning of a relative record file is specified 
by logical record 0; the end of the relative record file is specified by the highest numbered logical 
record, which is automatically identified with an end-of-file mark. No subfiles exist in relative 
record files. 



1-3 

Digital Systems Division 




946259-9701 



Logical records in a relative record file have a fixed length defined when the file is created. If the 
user tries to write a record larger than the specified record length, the record is truncated. If the 
record is shorter than the fixed record length, the record is binary zero filled. 

By initially coding the logical record number to zero, the relative record file may be automatically 
written or read sequentially until the highest logical record number is reached. After a read or write 
I/O Jile operation, the logical record number is incremented by the file management task; the logical 
record number is also incremented, or decremented, when the relative record file is rewound, 
forward spaced or backward spaced. The user may access any record at random by specifying the 
desired logical record number. Subsequent accesses may be either random or sequential. When 
another relative record number is specified out of sequence, access is at random. When none is 
specified, the next record in sequence is accessed. 

1.3.4 PROGRAM FILES. Program files are relative record files used to contain a program memory 
image; i.e., the linked object of one task segment and possibly one procedure segment and up to 
256 overlay segments. Program files are created by the Link Editor in IMAGE format. A program 
file may contain only one task and one procedure. 

A program file contains several records of system overhead information, and then the linked object 
of a program (task, procedure, and overlays). The object code is in a format such that it can be 
loaded directly into memory by the image loader. By linking programs into program files, the user 
may save diskette space and load time. Programs in program files take 25%-40% less time to load 
than programs in compressed or noncompressed object files, and require approximately 25% less 
diskette space. 

1.4 LOGICAL I/O 

TX990 uses logical unit numbers (LUNOs) to represent physical devices and files. User tasks are 
coded to perform I/O to a LUNO, which is converted by the operating system to represent the 
physical device or file to which the LUNO is assigned. This enables a user to code an I/O operation 
independent of a specific hardware or file configuration. 

LUNOs may be assigned and released by a task using I/O Supervisor Call 00 operations or operator 
commands. A LUNO is assigned to a pathname, which may be either a device name (14 characters) 
or a file name. Pathname format and syntax is described in the following paragraph. LUNOs may 
range in value from to FF 16 . 

1.4.1 PATHNAMES. A pathname may be the name of a device or a file. If a pathname represents a 
device, it is the name (1-4 characters, first must be alphabetic) assigned to that device at system 
generation (e.g., CS1, LP, CR). 

If a pathname represents a file, it has the following format: 



<device name> 
< volume name> 



:<file name> / [<extension of file name>] 



The first pathname component is optional, and is the name of the diskette drive or diskette volume 
which contains the file. A volume name is \A characters, like a device name. The first character 
must be alphabetic; the remaining characters must be alphanumeric. A volume name may only be 
used if volume name support is selected during system generation (see Section IX). TI supplied 
TX990 systems do not include volume name support. The default value for this pathname 
component is defined during system generation. 
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The second pathname component consists of a colon (:) and a 1-7 character file name. The first 
character of the file name must be alphabetic; the rest may be alphanumeric. 

The third pathname component is an optional 1-3 character extension of the file name. The first 
character must be alphabetic or blank; the rest must be alphanumeric or blank. If an extension is 
used, it must be separated from the file name by a slash (/) character. Optionally, the slash may be 
used alone, and the extension is interpreted to be three blanks. If no slash-extension is used, the 
extension is again interpreted as blanks. 

The following are examples of legal pathnames: 

:FILE File name, 1 to 7 characters; the device name is the 

default disk name. 

DEV:FILE Device and file name; the extension is defined as 

blanks. 

VOL: FILE Volume Name 1 to 4 characters; the extension is 

defined as blanks. 

:FILE/EXT File name and file extension name; the extension can 

be 1-3 chars. The device name is the default disk 
name. 

DEV:FILE/EXT Complete pathname with no defaults. 

VOT .'F"TT .F/F."X"T f~V»mr\1c»t£i r\a + VltiQTT"i£> \iri+Vi nn rlofonH 

■ ~ ~ '•*■ - — .— ; ~.. - ~ v/viuj/ivw j/uuuiuiiiv uiui n\j uviaun 

DEV:FILE/ Defaults to a blank extension 

VOL:FILE/ Volume name, and file name, extension defaults to 

blank extension. 

Trailing blanks are allowed at the end of each field (as presented below), but embedded blanks are 
not allowed within the field itself. 

DSC:FILEWtf/tfW is the same as :FILE/or :FILE 

NOTE 

The above example assumes that DSC was generated as the default 
diskette name during system generation. 

1.4.2 I/O MODES. Three I/O modes of operation are employed: file mode, record mode, and 
character mode. I/O devices are designated for file, record or character mode of operation during 
system generation. An I/O device placed in the file mode is assigned to the calling task when an 
open I/O operation is employed and remains assigned to that calling task until a close operation is 
performed. An I/O device placed in the record mode remains assigned to the calling task only during 
execution of the individual I/O operation. In the record mode, a Video Display Terminal (VDT) has 
a LUNO assigned to enable execution of an I/O operation. However, a 911 or 913 VDT is also 
capable of being operated in the character mode. The character mode enables the VDT to be 
uniquely programmed and accessed by a station number, rather than a LUNO. 
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1.5 SUPERVISOR CALLS 

Tasks request the support of the operating system by executing supervisor calls that are routed 
through a supervisor call interface to an associated supervisor call processor. A substantial number 
of file management supervisor calls and task control calls are supported by the operating system. 
The user may also include his own custom supervisor call processors if desired. The different 
supervisor calls provided by TX990 are described in Sections VI and VII. 

1.6 OPERATOR INTERFACES 

TX990 optionally provides two operator interfaces, the Operator Communications Package (OCP) 
and the Control Program. A customized TX990 system may include neither, one, or both of the 
interface packages. The Control Program prompts the operator to load and execute any system 
utility or user program. It also provides a means of passing parameters to the program. The Operator 
Communications Package provides several commands which may be entered by the operator, and 
which perform various system functions (e.g., loading or executing programs, and debugging 
capabilities). The two operator interfaces are described in Sections III and IV. 

1.7 SYSTEM MEMORY LAYOUT CONSIDERATIONS 

Figure 1-1 shows the flow of control within a TX990 that includes all options. The task scheduler 
initiates execution of a user task as previously described. The task requests support of the executive 
by executing SVCs that are processed by the supervisor call interface. I/O supervisor calls are 
processed by the I/O Supervisor (IOS), and other supervisor calls are processed by their respective 
supervisor call processors. Following execution of a supervisor call, the supervisor call interface 
returns control either to the calling task or to the task scheduler, according to the type of supervisor 
call. Interrupts from the clock and from active I/O devices are processed by the appropriate handler, 
which passes control to a common interrupt return after processing the interrupt. The common 
interrupt return passes control to the point in the task or executive at which the interrupt occurred. 

In figure 1-1, the optional portions of TX990 are shown outlined with dashed lines. Figure 1-2 
shows memory maps of several possible configurations of TX990. The minimal system consists of 
the basic configuration shown in figure 1-2 A. This provides a basic task scheduling and an interrupt 
processing monitor for a small static system. The minimal TX990 Operating System includes the 
data structures, task scheduler, supervisor call interface (with dummy supervisor call processors), 
and the interrupt processor. The user tasks in this type of system are linked and loaded with the 
system and perform any I/O operations without the aid of TX990. 

The addition of supervisor call processor modules, I/O supervisor call processor modules, and Device 
Service Routine (DSR) modules results in the configuration shown in figure 1-2B. In this 
configuration, it is necessary to link and load user tasks with the system. 

The addition of OCP modules as shown in figure 1-2C adds the capability of operator interaction 
with the oSystem ssing OCP commands. Addition of a dynamic task area, also shown in figure 1-2C, 
allows the operator to load a task or tasks by OCP command into the dynamic task area for 
execution. This capability, along with the use of OCP commands, enables debugging of tasks. Other 
user tasks must be linked and loaded with the operating system. 

The addition of file management modules, as shown in figure 1-2D, adds the capability of 
performing I/O operations with diskettes. This capability is necessary when the user wants to 
configure the Operating System using Terminal Executive Development System (TXDS). TXDS 
provides the user with those utilities necessary for software development (see the TXDS 
Programmer's Guide, part number 946258-9701, for details). 
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Figure 1-2. Typical TX990 Operating System Configurations 



A system configured as shown in figure 1-2 A requires less of available memory for system purposes 
(overhead) than the other configurations, and is desirable where minimizing memory overhead is the 
most important consideration. The additional support provided by the other configurations requires 
that more memory be available for system use. 

Systems configured as shown in figure 1-2 A and B support user tasks that are identified to the 
operating system during system generation and are linked and loaded with the operating system. 
These tasks occupy the area of memory beyond the area occupied by.TX990, and may be placed in 
execution when the operating system is loaded. Operating Systems configured as shown in 
figure 1-2C and 1 -2D also support these types of tasks but, in addition, they support a dynamic task 
area into which tasks may be loaded and executed by OCP command. The dynamic task area 
consists of the available memory beyond the area occupied by the other user tasks. 
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SECTION II 
LOADING THE OPERATING SYSTEM 



2.1 INTRODUCTION 

The TX990 operating system may be loaded into memory from a diskette or a cassette. Basically, 
two methods may be used to load the operating system: (1) a ROM loader can execute and load the 
TXBOOT program from diskette which in turn loads the Operating System; or (2) a ROM loader 
can execute and load the operating system directly into memory from a cassette or cards. More 
specifically, when the operating system is loaded from a diskette, a diskette/cassette ROM loader is 
utilized and the TXBOOT loader is loaded from a diskette; when the operating system is loaded 
from cassette, a diskette /cassette ROM loader or a card /cassette ROM loader is utilized. 

This section provides the step-by-step procedures required to achieve successful loading with each 
method. The initilization procedure required to be performed after the operating system is loaded 
into memory is also presented in this section. Two alternative initialization procedures are 
presented: one is used when an Operator Communication Package (OCP) is supplied with the 
operating system and the other is used when the TX990 Control Program and no OCP is supplied 
with the operating system. Any operator interaction with an operating system that does not include 
OCP capability must be provided by either user tasks or user-supplied system modules. At the end 
of this section, a procedure is provided to manually restart the system in event a system failure does 
not cause the contents of memory to be altered. 

When an error occurs, the error code is displayed by the indicators on the front of the Programmer 
Panel and the FAULT indicator is turned on. (See Appendix H, Printout of Fatal Task Error Codes 
or Display of Illegal Interrupt Code.) When an Operator Panel is used in the system, any error which 
occurs during loading causes the FAULT indicator to turn on and stay on. 

2.2 LOADING THE TX990 OPERATING SYSTEM 

The following paragraphs describe four methods for loading a TX990 operating system. 

1. Insert one of the three operating system diskettes (i.e., the diskette which contains the 
913 VDT operating system, the 733 ASR operating system, or the 91 1 VDT operating 
system) into any diskette drive. 

2. Sequentially depress the HALT/SIE, RESET, and LOAD switches on the front of the 
programmer panel. The TXBOOT program will now load into memory, followed by the 
TX990 operating system. 

NOTE 

The ROM loader tries to load from each of the first four diskette 
drives, beginning with diskette drive 0, until a READY drive is 
found. If none of the diskette drives indicate READY, the ROM 
loader will load from the cassette drive that is in the PLAYBACK 
mode and in the READY state. 
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3. When successful loading of the TXBOOT program and the operating system is completed, 
observe the following printed output or display from the system console (provided the 
Initial Start Task (ST ASK) module-feature is supplied with TX990): 

TX990 SYSTEM RELEASE 2 .2 

MEMORY SIZE (WORDS): 16384 AVAILABLE: 5940 

(where the memory size printout or display is in decimal numbers specifying the quantity 
of memory words; the size, in words, of the dynamic task area is printed out as available 
memory). 

NOTE 

1. When the user does not include a task that produces an 
indication of successful loading of the operating system, the 
only possible way to verify successful loading is by usage of the 
operating system. 

2. The operating system diskette being used during the loading 
procedure must have the diskette boot program written on 
allocation units through 4, and the system file pathname must 
be defined. All standard TI diskettes have the diskette boot and 
the system file pathname previously defined; however, if the 
user wants to create an operating system diskette, the diskette 
boot program can be written and the system file pathname can 
be defined by using the Set System File (SF) command from 
the Diskette OCP System Utility (SYSUTL) Program. For 
information relating to SYSUTL, see the Diskette OCP System 
Utility (SYSUTL) Program section in this manual. 

4. After loading of the operating system is completed (i.e., after the printed output or 
display appears on the system console as specified in the previous step), perform the 
initialization procedure presented in paragraph 2.3. 

2.2.2 LOADING FROM CASSETTE USING DISKETTE/CASSETTE ROM LOADER. Proceed as 
follows: 

1. Place the cassette which contains the TX990 operating system in either of the two 
cassette drives of the 733 ASR terminal. 

NOTE 

For operating instructions covering the cassette unit, refer to the 
Model 990 Computer 733 ASR/KSR Data Terminal Installation and 
Operation Manual, part number 945259-9701. 

2. Rewind the operating system cassette. 

3. Place the cassette unit in the PLAYBACK mode and in the READY state. 

4. Press the HALT/SIE switch and then the RESET switch on the Programmer Panel. 
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5. Place the number 0080i 6 into memory address 0080 x 6 as follows: 

a. Press the CLR switch and the 8 switch on the Programmer Panel to set the displayed 
value to 0080 16 . 

b. Press the ENTER MA switch on the Programmer Panel. 

c. Press the MDE switch on the Programmer Panel. 

6. Load TX990 into memory by pressing the LOAD switch on the Programmer Panel. 

7. When loading of the operating system program is completd, observe the following printed 
output or display from the system console (provided the Initial Start Task (STASK) 
module-feature is supplied with TX990): 

TX990 SYSTEM RELEASE 2.2 

MEMORY SIZE (WORDS): 16384 AVAILABLE: 5940 

(where the memory size printout is in decimal numbers specifying the quantity of 
memory words; the size, in words, of the dynamic task area is printed as available 
memory). 

8. After loading of the operating system is completed (i.e., after the printed output or 
display appears on the system console as specified in the previous step), perform the 
initialization procedure presented in paragraph 2.3. 

2.2.3 LOADING FROM CASSETTE USING CARD/CASSETTE ROM LOADER. Proceed as 
follows: 

1 . Place the TX990 operating system cassette in either of the two cassette drives of the 733 
ASR terminal. 

NOTE 

For operating instructions covering the cassette unit, refer to the 
Model 990 Computer Model 733 ASR/KSR Data Terminal 
Installation and Operation Manual, part number 945259-9701 . 

2. Rewind the operating system cassette. 

3. Place the cassette unit in the PLAYBACK mode and in the READY state. 

4. If the system has an Operator Panel instead of a Programmer Panel, proceed to the next 
step. If the system has a Programmer Panel, press the HALT/SIE switch and then the 
RESET switch. 

5. Load the operating system into memory by pressing the LOAD switch on the 
Programmer Panel. 
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When loading of TX990 is completed, observe the following printed output or display 
from the system console (provided the Initial Start Task (STASK) module-feature is 
supplied with TX990): 



TX990 SYSTEM 



RELEASE 2.2 



MEMORY SIZE (WORDS): 16384 



AVAILABLE: 5940 



(where the memory size printout is in decimal numbers specifying the quantity of 
memory words; the size, in words, of the dynamic task area is printed as available 
memory). 

7. After loading of the operating system is completed (i.e., after the printed output or 
display appears on the system console as specified in the previous step), perform the 
initialization procedure presented in paragraph 2.3. 

2.3 INITIALIZATION 

Two initialization procedures are available: one for use when OCP is included in the operating 
system and the other for use when the Control Program is included. When OCP is included in the 
operating system, OCP commands may be entered on a system console such as a 733 ASR Data 
Terminal, or a 913 or 91 1 Video Display Terminal. The system console is defined during the system 
generation, and LUNO is assigned to the system console device at that time. Refer to table 2-1 for 
a list of the standard TX990 device names. 

Table 2-1 . Standard TX990 Device Names 



Device 



Device Name 



733 ASR/KSR Keyboard/Printer 

743 KSR Keyboard/Printer 

733 ASR Cassette Unit 1 (Unit on left) 

733 ASR Cassette Unit 2 (Unit on right) 

Line Printer 

Card Reader 

913 or 91 1 Video Display Terminal 

Dummy 

Diskette Unit 1 (Unit on left) 

Diskette Unit 2 (Unit on right) 

Communication Device 

Teletype Keyboard/Printer 1 

Teletype Paper Tape Reader 1 

Teletype Paper Tape Punch 1 

1 Supported by Texas Instruments as a nonstandard item. 



LOG, ASR 

LOG, KSR 

CS1 

CS2 

LP 

CR 

CRT, LOG 

DUMY 

DSC 

DSC2 

COM 

LOG, ASR 

PTR 

PTP 



2.3.1 INITIALIZATION USING OCP. Proceed as follows: 

1 . Enter an exclamation point (!) at the keyboard of the system console. This activates OCP, 
which responds by printing a period (.) to request entry of a command. 
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2. Assign LUNO 1 to a printing or display device on which information is to be displayed or 
printed. Table 2-1 lists device names in the operating system supplied by Texas 
Instruments. The standard TX990 assigns LUNO 1 to the system console. The following 
is an example of a command to assign LUNO 1 to a line printer. The command is 
followed by a carriage return. 

.AL,1,LP. 

3. When TX990 includes date and time support, initialize the date and time. The following 
command initializes the time and date to 3:42 P.M., February 3, 1976. The command is 
followed by a carriage return. 

.ID,1976,2,3, 15,42. 

The operating system responds by printing time and date information (updated 
approximately), in the following format: 

15:42:18 FEB 3, 1976 

At this point, other commands may be entered to perform available functions. The OCP commands 
are described in Section III. 

2.3.2 INITIALIZATION USING THE CONTROL PROGRAM. Proceed as follows: 

1. Enter an exclamation point (!) at the keyboard of the system console. This activates the 
Control Program, which prints the following heading and prompt: 

TXDS 936215 *A 

PROGRAM: 

2. Insert the TX990 parts diskette in drive 1 . 

3. Activate the OCP System Utility Program (SYSUTL) by responding to the PROGRAM: 
prompt as follows: 

PROGRAM : : S YSUTL/SYS * 

4. Initialize the time and date by responding to the SYSUTL OP: prompt as follows: 

TX990 SYSTEMS UTILITY 937544 *B 

OP: ID, <year>, <month>, <day>, <hour>, <minute>. TE. 

SYSUTL returns controls to the Control Program. 

2.4 MANUAL SYSTEM RESTART 

When the TX990 operating system is used in a Model 990 Computer equipped with a Programmer 
Panel, it is possible to restart the system without performing another loading procedure. A restart is 
appropriate in the event a system failure did not alter the contents of the system area of memory. 
To restart the system, perform the following steps at the Programmer Panel: 
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1 . Transfer control to the Programmer Panel by pressing the HALT/SIE switch. 

2. Press the RESET switch. 

3. Press the CLR switch and observe that the indicators of the display are not lit. 

4. Press the 8 switch and the 10 switch, setting a number of 00A0 16 in the display. 

5. Press the ENTER PC switch. 

6. Press the RUN Switch. 



NOTE 

A standard Tl-supplied TX990 Operating System does not execute 
Initial Start Task (STASK) after a restart operation and, therefore, 
no display or printout is presented on the system console. 

7. Perform the initialization procedure presented in paragraphs 2.3.1 or 2.3.2. 



2"6 Digital Systems Division 




946259-9701 



SECTION HI 
OPERATOR COMMUNICATION PACKAGE (OCP) 



3.1 INTRODUCTION 

OCP allows the user to interactively request actions from the operating system through a terminal 
(e.g., 733 ASR, 743 KSR, 33 Teletype, 911 or 913 VDT). Actions are initiated by the user by 
responding to the OCP command prompt (a period) with one of the OCP commands described in 
paragraph 3.5. 

Processing of operator commands is performed by five or more modules of the Operator 
Communication Package (OCP). OCP consists of four required modules and five optional command 
processor modules. These modules are described in the system generation section of this manual. 
The user may modify the OCP commands, add one or more command processors to a command 
processor module, or add one or more command processor modules to OCP. 

3.2 ACTIVATING AND DEACTIVATING OCP 

In a TX990 system which includes OCP, it is initiated at the system console by entering an 
exclamation mark (!). OCP responds by prompting for a command, displaying a period (.): 



OCP may not be activated in a system which does not have the OCP modules linked-in (i.e., OCP 
may not be executed as a dynamic task). 

OCP is deactivated by issuing the OCP Terminate (TE) command in response to a prompt: 
.TE. 

3.3 LUNOs 

/~v/nn j. t TT\Tn. 1 „„J <"> T TTXT/"* 1 1^ nnntn«a/1 +/-» tliQ AaiAi^a +/-» \%t\i\cV\ q11 mpcoQOPC r\T oiitrwit ic 

VJ^r UiieS IWU LU1NUS, 1 itilU jL. i-,yjiyKj i is aaaigiivu \,vj niv sawxw^ w »i"vn uu mvuuu b v U w* wv»vj^v»v ^ 

to be directed. LUNO 2 is assigned to the device which contains a file (e.g. object program) being 
input. 

3.4 COMMAND FORMAT AND SYNTAX. 

Each command consists of a command word, optionally followed by one or more operands. OCP 
recognizes a command by the first two letters of the command word; these letters may be followed 
by additional letters or by blanks. One or more blanks, or a comma, may separate a command word 
and operands. However, embedded blanks are not allowed within the command word or an 
operand. More than one command may be entered in a single line, which may contain up to 72 
characters and must be terminated by a carriage return (NEW LINE on 911 or 913 Video Display 
Terminal). When more than one command is entered on one line, each command must be 
terminated with a period (the period may be omitted following the last command on the line). 
When an error is detected in a command, any subsequent command on that line is ignored. Two 
consecutive commas are interpreted as a null operand, which may be used to omit an optional 
operand. When a null operand is entered for a numeric operand, the null operand takes the value of 
zero. When a null operand is entered for a character operand, the null operand takes the value of a 



3-1 Digital Systems Division 




946259-9701 



blank. If a command generates printout to a hardcopy device such as a 733 ASR, the printout can 
be aborted by pressing the ESCape key. If a line is entered in error and if the carriage return has not 
yet been entered, the operator may press the RUB OUT key. This deletes the entry from the OCP 
input buffer, and the user can then enter a correct command. 

NOTE 

All numeric OCP inputs are assumed to be hexadecimal numbers. 

The following examples illustrate the manner in which OCP interprets equivalent commands entered 
in different ways. The commands in the examples are equivalent and valid. 

.DMEM,0000,0010. The complete command word is entered with two 

hexadecimal operands separated by commas and 
terminated with a period. 

•DM 10 The command word is entered in two-letter form; 

blanks are used as separators; leading zeros are 
omitted; and the period is omitted. (Period is not 
omitted when another command is entered on the 
same line.) 

.DMEM, 10 The complete command word is entered; an addi- 

tional blank is entered; a comma is used as a separator 
in one place and a blank in another. 

.DM,, 10 The command word is entered in two-letter form, and 

first operand is entered as a null operand. 

.DMXXX,0000 10 The first two letters of the command word are fol- 

lowed by other letters; a blank is used as a separator. 

.DM 10 XYZ 55 This is the same as the second example except for 

additional operands, which are ignored. 

In subsequent definitions of OCP commands, the following notation is used. 

• Angle brackets < > enclose items supplied by the user 

• Brackets [ ] enclose optional items 

• Braces \ \ enclose alternative items, one of which must be entered 

• An ellipsis (...) indicates that the preceding item may be repeated 

• Items shown in capital letters must be entered as shown 

3.5 OCP COMMANDS 

The OCP commands are divided into the following groups: task support commands, debugging 
commands, I/O utility and status commands, time and data commands, and the termination 
command. Table 3-1 shows every OCP command and its syntax. 
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Available only 
with multiple 
dynamic task 
support. 



\ 



JAL 1 

JalunoI 

RL 
IRLUNO 



Ilprog 



Jex 

(execute 

JIT 
ilTASK 

iiP . 

lIPROCl 



|DT 

Idtask 

DP 
DPROC 



Table 3-1 . Syntax of OCP Commands 
OCP Task Support Commands 

,<luno>,<pathname>, 

,<luno>, 

,<pathname>[,[<priority>] [P] ] 

,<task id>[,<parml>[,<parm2>] ]. 

,<pathname>,<task id> [,<priority>] [,<procedure id>] [,P] [,N] 



,<procedure id>. 



,<task id>. 



,<procedure id>. 



(urn 
DMEN 

JLM j 

Ilmeni 

I SB 
ISBKPT 

|CB 
ICBKPT 

AD 1 

add) 

SU I 
SUB I 

l ,M I 

IJMPl 



OCP Debugging and Error Recovery Commands 

,<starting address>[,<ending address>]. 

,<address>,<value>[,<value>] ... 

,<address>. 

[,<address>]. 

,<value>,<value>. 

,<value>,<value>. 

,<address>,<address>. 
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Available only with 
multiple dynamic 
task support. 



Table 3-1 . Syntax of OCP Commands (Continued) 
OCP Debugging and Error Recovery Commands (Continued) 



JDW J 

Idwksp) 

KT 
DTASK 

KI 
KIO 

TR I 
TRACE J 



,<task id>, 

,<task id>. 

,<luno>. 

[,<address>]. 
OCP I/O Utility and Status Request Commands 



RE 
REQIND 


,<luno>. 


FS 
FSPACE 


,<luno>,<number> 


BS 
BSPACE 


,<luno>,<number> 


ST 1 
STASKI 


[,<taskID>]. 


s, 1 
siol 


[,<luno>] 


SP 1 


[,<procedure kl>]. 



SPROC 



TI 
TIME 



OCP Time and Date Commands 



ID I 

i ,<year>,<month>,<day>,<hour>,<minute>. 

IDATEj 



TE 
TERMINATE 



OCP Termination Command 
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Each group of commands is discussed in detail in a subsequent paragraph. 

3.5.1 OCP TASK SUPPORT COMMANDS. These commands are processed by either module 
OCPLRT or module DOCPLRT, and enable the user to assign and release LUNOs, load programs 
into the dynamic task area, and execute programs, through a terminal. DOCPLRT should be used to 
support multiple dynamic tasks. 

3.5.1.1 Assign Logical Unit Number (AL or ALUNO). The Assign Logical Unit (AL or ALUNO) 

command assigns a logical unit to a pathname. The syntax for the command is as follows: 

{ ALUNO J ' <luno> ' <pathname>. 

The LUNO operand is a hexadecimal number from through FE 16 . In systems that include OCP, 
LUNO is a system LUNO and may not be assigned by the user. When a previously assigned LUNO 
is reassigned, the previous assignment is released unless a task is performing I/O to the LUNO. 
When a task is performing I/O to the LUNO, the LUNO is neither released nor reassigned and an 
error message is printed. 

The following are examples of ALUNO commands: 

AL,10,CR. Assign LUNO 10 16 to the card reader. 

ALUNO, 1 1 ,LP. Assign LUNO 1 1 16 to the line printer. 

AL, 10, .FILE/SYS. Assign LUNO 10 16 to a disc file. 

Error messages are discussed in paragraph 3.6 and in Tables 3-2 and 3-3. 
Error messages 1 through 6 (Table 3-3) apply to the AL or ALUNO command. 

3.5.1.2 Release Logical Unit Number (RL or RLUNO). The Release Logical Unit (RL or RLUNO) 

command releases the assignment of a LUNO to a physical device or file. An attempt to release a 
LUNO to which a task is performing I/O results in an error message. The syntax for the command 
is as follows: 

' RL * ,<luno>. 



I RLUNO 



i- 



The LUNO operand specifies a LUNO to be released. The following is an example of an RLUNO 
command : 

RL,1A. Release LUNO 1A 16 . 

Error messages 1 through 4 (table 3-3) apply to this command. 
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3.5.1.3 Load Program (LP or LPROG). The Load Program (LP or LPROG) command reads the 
object code on the specified device and installs it in the dynamic task area. When a task that was 
previously installed in the dynamic task area has not terminated, the current task is not installed 
and an error message is printed. The snytax for the command is as follows: 

/LP \ ,<pathname>[ ,[<priority>] [ ,P] ] . 

The pathname operand is the name of the input device or file appropriate for the module that 
contains the object code for the task. OCP assigns LUNO 2 to the device. The priority operand 
is the priority level, through 3, of the task. When the priority operand is omitted, priority level 3 
is assigned to the task. The third operand is the letter P to specify that the task executes in the 
privileged mode. When the third operand is omitted, the task executes in the nonprivileged 
mode. 

The task identifier (ID) of a task installed with the LRROG command is 10 16 . 

When loading from a cassette, the LPROG command processor does not perform a rewind operation 
prior to reading the module. It is necessary for the user to position a cassette to the desired object 
module. When loading from a diskette file, the file is automatically rewound. 

The following examples show use of LPROG commands: 

LPROG ,CSL Read the object module (i.e., the program or task) 

from the cassette in cassette drive 1 and install the 
module in the dynamic task area at priority level 
3. 

LP,CR,2. Read the object module from the card reader and 

install the module in the dynamic task area at priority 
level 2. 

LP,DSC2:IBMUTL/SYS,3,P. Read the object module from the diskette in diskette 

drive 2 and install the module in the dynamic task 
area at priority level 3 as privileged. 

Error messages 1 , 2, 5, 6 and 7 through 1 1 (table3 : 3) apply to this command. 

3.5.1.4 Execute Task (EX or EXECUTE). The Execute Task (EX or EXECUTE) command places 
the specified task in execution. Execution begins when the task becomes the oldest task on the 
active list for its priority level, and no task at a higher priority level is active. The syntax for the 
command is as follows: 



\ EXECUTE; >< task id>[,<parameterl>[,<parameter2>] ] 



The task ID operand is a two-digit hexadecimal operand. The task ID of the task installed in the 
dynamic task area is 10 16 . Task IDs of resident tasks are assigned when the system is generated. 
The parameter operands are optional task parameters, each of which is a hexadecimal number of up 
to four digits. When the operands are omitted, TX990 supplies zeros. The task obtains the 
parameters by executing a Get Parameter supervisor call, described in Section IV. 
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The following are examples of EXECUTE commands: 

EX, 10. Execute task 1 16 , installed in the dynamic task area. 

EX,11,4845,4C50. Execute task 11 16 , and passes the characters HELP to the task. 

.EXECUTE, 10,1C. Execute the task installed in the dynamic task area, and pass the 

value 1C 16 (28) to the task. 

Error messages 1 and 12 (table 3-3) apply to this command. 

3.5.1.5 Install Task (IT or IT ASK). The Install Task command loads an object module from a 
sequential file into the dynamic task area. The syntax of the command is as follows: 

/IT I 

UTASKj ,<pathname>, <task id> [,[<priority>] [,[<procedure id>] [,P] [,N] ] ] 

The <pathname> is the name of the sequential file or device which contains the object module of 
the task being installed, and is required. 

The required <task id> parameter is the ID to be assigned to the installed task. Valid IDs are in the 
range of 1 16 to EF 16 . 

The optional <priority> parameter is the priority (0 to 3) at which the task will execute. The 
default value is 3, the lowest priority. 

-f'PrrtrfHiirio irT*!> ic flip TT~) nf a nrpvinnclv installpH nrnrp.Hnrp. whir.h is fn he. attached tn the task 

when loaded. If no value is given, no procedure is attached to the task. 

The letter P is used to specify that the task should execute in privileged mode; if not used, the task 
is nonprivileged. 

The letter N is used to prevent the input file <pathname> from being rewound before the task is 
loaded. If N is not used, the file is rewound. 

The following examples show the use of the Install Task command: 

ITASK, DSC: TASK/OBJ, 30, 3, 10, P, N 

Read the object module from file :TASK/OBJ and install it as task 30 16 with priority 3. 
Attach procedure 10 16 and make the task privileged. Do not rewind the file. 

IT, CS1,CB. 

Read the object module from CSl and install it as task CB 16 . The task is nonprivileged, has no 
attached procedures, and has priority 3. 

3.5.1.6 Install Procedure (IPROC). The Install Procedure (IPROC) command reads the specified 
file and installs it in the dynamic task area. The syntax for the command is as follows: 

/IP ) 

iIPROCl ,<pathname>,<procediire id> 

The <pathname> is the name of the sequential file or device which the object module of the 
procedure being installed, and is required. 
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The < procedure id> specifies the procedure to be installed with the IP ROC command. If a 
procedure with the same id is already installed, the new procedure is not installed and an error 
message is returned. 

3.5.1.7 Delete Task (DTASK). The Delete Task command deletes a task from memory and returns 
the memory occupied by the task to the available memory pool in the dynamic task area. The 
syntax for the command is as follows: 

{dtask} < taskid >- 

The task previously installed with an ITASK command using the same <task id> is deleted. If a task 
with the specified ID is not installed in the dynamic task area, no task is deleted, and an error 
message is printed. When a procedure is attached by an ITASK command to the task being deleted, 
the task is detached from the procedure. A task linked with the system may not be deleted .* 

3.5.1.8 Delete Procedure (DPROC). The Delete Procedure command deletes a procedure from 
memory and returns the memory to the available memory pool in the dynamic task area. The 
snytax for the command is as follows: 

{dPROc} procedure id>. 

The procedure previously installed with an IPROC command using the <procedure id> is deleted 
unless one or more tasks are attached. When one or more tasks are attached or a procedure with the 
specified ID is not installed, the procedure is not deleted, and an error message is printed. 

3.5.2 OCP DEBUGGING AND ERROR RECOVERY COMMANDS. These OCP commands are 
processed by Command Processor module OCPSLD and OCPTLD, and enable the operator, by use 
of the system console keyboard, to perform some real debugging operations; dumping and loading 
memory, which allows the user to patch his task or to examine different variables in memory; 
setting and clearing run-time breakpoints in a task; adding and subtracting hexadecimal addresses; 
calculating JMP instruction displacements; and dumping the current workspace of an executing 
task. These commands are described in the following paragraphs. 

3.5.2.1 Dump Memory (DM or DMEM). The Dump Memory (DM or DMEM) command causes 
OCP to print the contents of specified sequential memory locations on the device to which LUNO 1 
is assigned. The syntax for the command is as follows: 

/DM 



IDMFM I >< startm S address>[,<ending address>] . 



The starting address operand is a one- to four-digit hexadecimal address of the first memory 
location to be displayed. The optional ending address operand is a one- to four-digit hexadecimal 
address of the last memory location to be displayed. When the ending address operand is omitted, 
the ending address is equal to the starting address. Contents of eight memory words are printed 
on one line, following the address of the first memory location displayed. The contents are dis- 
played in hexadecimal representations and in ASCII character representations, with nonprinting 
characters printed as periods. OCP displays a multiple of eight words; when the ending address is 
omitted or when the ending address is greater than the starting address by 16 or less, one line is 
printed. Similarly, the last line printed includes the contents of the ending address and any addi- 
tional words required to fill the line. When the starting address is an odd value, the next lower even 
address is used. 
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The following is an example of a DMEM command and the resulting display of memory contents: 

.DM, 1 5 ,34. Display contents of memory locations 00 1 5 16 through 0034 16 . 

0014 = 07BA 0796 0568 05E2 0568 05E2 0568 05E2 .. .. 

0024 = 0572 05B0 057C 05BC 0568 05E2 0568 05C8 .. > .. .. II 

0034 = 0568 05E2 0568 05E2 0590 05D4 0568 05E4 T .. .. 

Error message 1 (table 3-3) applies to this command. On a computer equipped with TILINE*, an 
attempt to address a nonexistent memory address terminates OCP. On other computers, the com- 
mand is executed, but gives unpredictable results, 

3.5.2.2 Load Memory (LM or LMEM). The Load Memory (LM or LMEM) command places 
values in memory at specified locations. The syntax for the command is as follows: 



l TMFM I >< aa "dress>,<value>[,<value>. . . .] 



The address operand is a one- to four-digit hexadecimal address into which the first value operand 
is placed. The value operand is a one- to four-digit hexadecimal representation of the value to be 
placed in a word of memory. When additional values are entered, they are placed in successive ad- 
dresses. When the address operand is an odd address, the value is at the next lower even address. 
The following is an example of an LMEM command: 

LM,0100,FFFF,1284. Place the values FFFF 16 and 1284 16 in memory words at ad- 

dresses 0100 16 and 1 02 16 , respectively. 

Error message 1 (table 3-3) applies to this command. On a computer equipped with TILINE*, an 
attempt to address a nonexistent memory address terminates OCP. On other computers, the 
command is executed but the results are unpredictable. 

3.5.2.3 Set Breakpoint (SB or SBKPT). The Set Breakpoint (SB or SBKT) command sets a break- 
point in a task. A breakpoint may be set in any resident task or in a task that has been installed in 
the dynamic task area 5 whether or not the task is active. Setting a breakpoint consists of replacing 
the contents of the specified breakpoint location with a single-instruction loop ( JMP $). 

CAUTION 

Do not mistakenly set the breakpoint outside of the task area, or a 
memory area other than the task area may be destroyed. 

As many as four breakpoints may be active at any one time. The syntax of the command is as 
follows: 

{ SBKPT }' <addreSS> ' 

The address operand is a one- to four-digit hexadecimal address at which the breakpoint is set. The 
following is an example of an SBKPT command: 

SB,048C. Set a breakpoint at the instruction at address 048C 16 . 

TILINE is a registered trademark of Texas Instruments Incorporated. 
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Error messages 1, 6, and 13 (table 3-3) apply to this command. On a computer equipped with 
TILINE, an attempt to set a breakpoint in a nonexistent memory address terminates OCP. On other 
computers, the command is executed, but the results are unpredictable. 

The user must be careful to set a breakpoint at the address of a single-word instruction, or at the 
address of the first word of a multiword instruction. Effects of setting breakpoints at other 
locations are unpredictable. 

3.5.2.4 Clear Breakpoint (CB or CBKPT). The Clear Breakpoint (CB or CBKPT) command clears 
one or all breakpoints in a task or system. A breakpoint may be cleared in any resident task or in a 
task that has been installed in the dynamic task area, whether or not the task is active. 

When a breakpoint occurs, a CBKPT command must be executed to continue execution of the task. 
Clearing a breakpoint consists of restoring the original contents of the breakpoint location. How- 
ever, when clearing a breakpoint is requested for a breakpoint location that no longer contains a 
single-instruction loop (JMP $) the contents of memory are not altered. The syntax for the 
command is as follows: 

{cbkpt} >< address >- 

The address operand is a one- to four-digit hexadecimal address of a breakpoint to be cleared. When 
the address is omitted, all current breakpoints are cleared. The following is an example of a CBKPT 
command: 

CBKPT,048C. Clear breakpoint at address 048C 16 . 

Error messages 1,12, and 14 (table 3-3) apply to this command. 

3.5.2.5 Add (AD or ADD). The Add (AD or ADD) command provides the sum of two values. The 
syntax of the command is as follows: 

I A nn 1 ><value>,<value>. 

The value operands are one- to four-digit hexadecimal numbers, and are added using the A machine 
instruction. The addition follows the rules that apply to the A instruction, and the result is not 
modified by the state of the Carry or Overflow bits following the operation. The following are 
examples of ADD commands and resulting sums: 

ADD,300,700. Adds 300, 6 to 700i 6 and prints the sum 0A00 16 . 

0A00 

AD,7FFF,8000. Adds 7FFF 16 to 8000 16 and prints the sum FFFF 16 . the maximum 

FFFF value that is represented without an overflow. 

AD.8000,8000. Add 8000 16 to 8000 16 and prints the four least significant digits of 

0000 the sum. 0000. 

Error message 1 (table 3-3) applies to this command. 
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3.5.2.6 Subtract (SU or SUB). The Subtract (SU or SUB) command subtracts the first of two 
specified values from the second, and prints the difference. The syntax for the command is as 
follows: 

iSUBf > <value >' <value> - 

The first value operand (subtrahend) is the value to be subtracted from the second value operand 
(minuend). Both operands are one- to four-digit hexadecimal numbers, and are subtracted using the 
S machine instruction. The subtraction follows the rules that apply to the S instruction, and the 
result is not modified by the state of the Carry or Overflow bits following the operation. The 
following are examples of SUB commands and resulting differences: 

SUB,500,A00. Subtract 500 16 from A00 16 , and prints the difference, 500 16 . 

0500 

SU,FFFF,100. Subtract FFFF 16 (-1) from 100 16 , and prints the difference, 101 16 . 

0101 

SU,1000,300. Subtract 1000 16 from 300 16 , and prints the difference, F300 16 

F300 (-D00 16 ). 

Error message 1 (table 3-3) applies to this command. 

3.5.2.7 Jump Instruction (JM or JMP). The Jump Instruction (JM or JMP) command builds a jump 
instruction having a displacement corresponding to the specified addresses. The JMP command 
~~i~+r, „„ ;„r,+™,-.+;/^« wn-rA ™ith a 1 qc the* firct Hioit nr»H tVip Hknlflr.RTTip.nt in the two least sienifi- 

cant digits. An asterisk follows the 1 and represents the second hexadecimal digit of a specific jump 
instruction; i.e., for JMP, 3 for JEQ, etc. The syntax for the command is as follows: 

ITMPI >< aQ, dress>,<address>. 

The address operands are one- to four-digit hexadecimal addresses; the first is that of the jump in- 
„+~,„+;~„ K a ;«r, Uniu • +Vi« cpmnH qHHi-p<:<: i« that nf the instruction to which control is to be trans- 
ferred by the jump instruction. The following are examples of JMP commands and the resulting 
instructions: 

JMP,109A,10B0. Build a jump instruction to be placed at address 109A 16 to jump to 

1*0A address 10B0 16 . 

JM,109A,1000. Build a jump instruction to be placed at address 109A 16 to jump to 

1*B2 address 1000 16 . 

Error messages 1 and 15 "(table 3-3) apply to this command. 

3.5.2.8 Dump Workspace (DW or DWKSP). The Dump Workspace (DW or DWKSP) command 
causes OCP to print the contents of the workspace of a specified task. When the debugging OCP 
described previously is not included, this command will not execute. OCP also prints the task ad- 
dress and the workspace pointer register contents. The syntax for the command is as follows: 



{ DWKSP } > <taskid> - 
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The task ID operand is the task identifier of the task. The task identifier is a one- or two-digit 
hexadecimal number assigned when the task was loaded. The following is an example of a DWKSP 
command and the resulting printout: 

DWKSP,0D. Print contents of workspace of task 0D 16 . 

ADR: 20F0 WP: 20F6 

20F6 = 06BE 06AE 06CA 06AC 06EA 070A 06EA 070A > 

2106= 05E4 0568 05E4 0568 05E4 0568 05E4 0568 .. .. 



On the first line, OCP prints the starting address at which the task was loaded, and the contents of 
the workspace pointer register. On the next two lines, the contents of the 1 6 words of the work- 
space are printed in the format of the DM command. The address of the first word on each line is 
printed as a four-digit hexadecimal number, followed by an equal sign. The address on the first of 
these two lines is the address that is in the workspace pointer register. To the right of the equal sign 
are eight four-digit hexadecimal numbers that represent the contents of workspace registers 
through 7 in hexadecimal representation. The ASCII representation of the same values is printed 
further to the right, with periods substituted for nonprinting ASCII characters. The contents of 
workspace register 8 through F are printed in the same format on the next line. 

Error messages 1 and 12 (table 3-3) apply to this command. 

3.5.2.9 Kill Task (KT or KTASK). The Kill Task (KT or KTASK) command forces termination of 
an executing task. If end action is specified by the task, it is taken. Otherwise, any I/O operations in 
progress are terminated in error; all assignments of file-oriented devices to the task are released; and 
any files that were opened are closed. The syntax for the command is as follows: 

{ktask} ' <task id> - 

The task ID operand is the task identifier assigned when the task was installed, and consists of two 
hexadecimal digits. The following is an example of a KTASK command: 

KTASK,2 1 . Force termination of task 2 1 16 . 

Error messages 1,12, and 16 (table 3-3) apply to this command. 

3.5.2.10 Kill I/O Operation (KI or KIO). The Kill I/O Operation (KI or KIO) command terminates 
any I/O operation to the specified device. If an I/O operation to the device is in progress, that 
operation is terminated in error. The syntax for the command is as follows: 

{kio } ><luno> - 

The LUNO operand is a hexadecimal number, the LUNO assigned to the device on which I/O is to 
be terminated. When the specified device is file-oriented, the command also closes the file, which 
releases the assignment of the device to the task. The following example shows a KIO command: 

KIO,30. Terminate I/O to the device or file to which LUNO 30 16 is assigned. 

Error messages 1 and 17 (table 3-3) apply to this command. 



3-12 Digital Systems Division 




946259-9701 



3.5.2.1 1 Trace (TR or TRACE). Trace (TR or TRACE) displays the current contents of a memory 
location on the programmer panel lights. When the contents of memory change, the programmer 
panel lights will also change. It has up to one parameter. This parameter is the hexadecimal memory 
address. If no parameter is given, the standard display, the Program Counter (PC), will be displayed 
on the programmer panel. By entering the command with no parameter, the trace is, in effect, 
turned off. 

TRACE, [< memory address> ] . 

3.5.3 OCP I/O UTILITY AND STATUS REQUEST COMMANDS. These OCP commands are 
processed by Command Process Module OCPIOU or DOCPIOU, and enable the operator, by use of 
the system console keyboard, to perform various I/O utility and status request commands. 
DOCPIOU should be included to support multiple dynamic tasks. 

3.5.3.1 Rewind Device (RE or REWIND). The Rewind Device (RE or REWIND) command 
initiates a rewind operation on a rewindable device or file. The syntax^ for the command is as 
follows: 



{rewind} • <luno> - 



The LUNO operation is a hexadecimal number, the LUNO assigned to the device or file to be re- 
wound. When the LUNO is assigned to a device that is not rewindable, the command is ignored. The 
following is an example of a REWIND command: 

RE,2C. Rewind the device to which LUNO 2C 16 is assigned. 

Error messages 1,17, and 18 (table 3-3) apply to this command. 

3.5.3.2 Forward Space (FS or FSPACE). The Forward Space (FS or FSPACE) command forward- 
spaces a sequential file or device a specified number of records. When the file or device forward 
spaces to an end-of-file (EOF) record, it remains positioned at the record following the end-of-file 
record. The syntax for the command is as follows: 

{ FSPACE } ,<luno>,<number>. 



The LUNO operand is the LUNO to which the device or file to be forward-spaced is assigned. When 
the LUNO is assigned to a device other than the cassette, the command is ignored. The number, a 
one- or two-digit hexadecimal value, is the number of records to be forward spaced. The following is 
an example of an FSPACE command: 

FS,1C,5. Forward space the device to which LUNO 1C 16 is assigned 5 records. 

Error messages 1, 17, 18, and 19 (table 3-3) apply to this command. 

3.5.3.3 Backspace (BS or BSPACE). The Backspace (BS or BSPACE) command backspaces a 
sequential file or device a specified number of records. When the cassette tape is at the beginning-of- 
tape marker, the command is ignored. The syntax for the command is as follows: 

{BSPACE}' <luno> ' <number> - 
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WP 


PC 


ST 


STATE 


PROC 


18FE 


1D38 


240F 


07 
04 
04 
04 


27 



The LUNO operand is the LUNO to which the device to be backspaced is assigned. The number, a 
one- or two-digit hexadecimal value, is the number of records to be backspaced. The following is 
an example of a BSPACE command: 

BSPACE,2E,10. Backspaces the device to which LUNO 2E 16 is assigned 10 16 records. 

Error messages 1, 17, 18, and 19 (table 5-4) apply to this command. 

3.5.3.4 Task Status (ST or STASK). The Task Status (ST or STASK) command causes OCP to 
print the current status of all tasks. The syntax for the command is as follows: 

{sTASk} «taskid». 

No operand is required; however, if <task id> is supplied, only the status of that one task will be 
printed. The following is an example of an STASK command and the resulting printout: 

. ST . 

ID PRIOR ADDR 

OF 01 18F8. 

OD 01 37CE 

10 01 38EE 

Al 02 BCAO 

0:02:53 JAN 1, 

OCP prints a heading, followed by a line for each task. In the first column, OCP prints the task ID. 
OCP prints the priority level of the task in the second column. The next four columns contain 
four-digit hexadecimal addresses. The first of these, under the heading ADDR, is the address of the 
task. Next, under the heading WP, is the value to be placed in the workspace pointer register when 
the task is executed. In the column headed PC is the program counter contents, and in the column 
headed ST is the status register contents. The contents of the WP, PC, and ST registers are the 
contents at the most recent execution of the task. The seventh column, headed STATE, contains 
the task state code used by task management. These codes are listed in Appendix G. The last 
column, headed PROC, is only specified if multiple dynamic tasks are allowed. It contains the 
procedure identifier if a procedure is attached to the task. It is blank when no procedure is attached 
to the task. 

Task identifiers and priority levels are assigned at system generation, except for tasks in the 
dynamic task area, which have identifiers and priority levels assigned by the ITASK command. 

Task addresses are those into which the tasks were loaded when the system was loaded, or during 
execution of the ITASK command. 

3.5.3.5 Status of I/O (SI or SIO). The Status of I/O (SI or SIO) command-request causes OCP to 
print the status of all assigned LUNOs or of a particular LUNO. The syntax for the command is as 
follows: 

{siol [,<«•"« 
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No operand is required. The following is an example of an SIO command and the resultant 
printout: 

.SI. 

LUNO PATHNAME TASK ID SYSLUN 

F0 DSC - Y 

Fl DSC2 - Y 

00 LOG - Y 

01 LOG - N 
06 DSC:TXCCAT/SYS - N 
10:11:10 JAN 5, 1977 

OCP prints a heading, followed by a line for each LUNO and, in the first column, OCP prints the 
hexadecimal digits of the LUNO. The PATHNAME column contains the device, or file name to 
which the LUNO is assigned; and the SYSLUN column contains YES for LUNOs designated for 
system use and NO for other LUNOs. The Task ID column contains hyphens for LUNOs that are 
not assigned to tasks, or the task identifier of tasks to which LUNOs are assigned. A LUNO for a 
file-oriented device is assigned to a task from the time the task issues an Open supervisor call. This 
call specifies the LUNO until the task terminates or issues a Close supervisor call for the LUNO. A 
LUNO for a record-oriented device is assigned to a task only during an I/O operation. If the status is 
requested for a LUNO which has not been assigned, the header line only will -be printed. 

.SI,20. 

LUNO PATHNAME TASK ID SYSLUN 



*~i\ ti.„ T»_~„~,4,,».« Ctntno CCDDnn mmmonH raiKPS OPP to 



3.5.3.6 Procedure siaius (ar or arKuc;. mc nuwuic mat^o v ^ *vw W 
print the current status of procedures. The syntax for the command is as follows: 

SPROC [< Procedure id> ] . 

The status of the specified procedure will be printed. When the <procedure id> is omitted, the 
status of all procedures will be printed. The following is an example of a SPROC command and the 
resulting printout. 

. SP . 

ID ADR # TASKS 

27 BE60 01 

0:02:37 JAN 1, 

OCP prints a heading, followed by a line for each procedure. In the first column, OCP prints the 
procedure identifier. Column two contains the address at which the procedure was loaded. OCP 
prints the number of tasks to which the procedure is attached in the third column. Procedure 
identifiers are assigned by the IPROC command. The number of tasks to which the procedure is 
attached is incremented each time an ITASK command specifies attachment of that procedure and 
is decremented each time a DTASK command deletes a task to which that procedure had been 
attached. 
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3.5.4 OCP TIME AND DATE COMMANDS. The OCP date and time commands are : 

• Initialize Date and Time (ID or IDATE) 

• Print Time and Date (TI or TIME) 

These OCP commands are processed by Command Processor Module OCPTAD and enable the 
operator, by use of the system console keyboard, to initialize time and date for the Operating 
System. The above listed commands are described in the following paragraphs. 

3.5.4.1 Initialize Date and Time (ID or IDATE). The Initialize Date and Time (ID or IDATE) 

command initializes the date and time values for the system. The syntax for the command is as 
follows: 

(IDATE j ' < y ear> ' <montn> ' <da y> ) < ho ur > 5 <minute>. 

The year operand is the four-digit decimal number of the years 1975 through 1999, and the month 
operand is the decimal number of the month, 1 through 12. The day operand is a one- or two-digit 
decimal number, 1 through 31, and the hour operand is a one- or two-digit decimal number, 
through 23. The PM hours are specified by the sum of 12 and the hour. The minute is the decimal 
number of the minute, through 59. The second is set to zero when the command is entered. After 
the command is entered, the time and date will be written to the log for verification. The following 
example shows an IDATE command: 

.ID, 1976,2, 12, 17,29. Initialize the time and date to 5:29 PM, February 12, 1976. 

5:29:00 FEB 12, 1976 

Error message 1 (table 3-3) applies to this command. 

3.5.4.2 Print Time and Date (TI or TIME). The Print Time and Date (TI or TIME) command 
causes OCP to print the time and date. The syntax for the command is as follows: 

(TI ) 
(TIME/ " 

The command requires no operands. The following example shows a TIME command and the 
resulting output : 

TI. 

9:29:12 FEB 13, 1976 

When the date and time have not been initialized, the time printed is the elapsed time from the 
most recent loading of the Operating System. 
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3.5.5 OCP TERMINATION (TE) COMMAND. The syntax for the TErminate (TE) command is as 
follows: 

|TE ) 

(TERMINATE f 

The command requires no operands. 

3.6 ERROR MESSAGES 

OCP prints two categories of error messages. The messages in the general category are shown in 
table 3-2. These messages are not related to any specific command. The messages in the operand 
category apply to one or more operands of specific commands. These messages are listed in 
table 3-3 and are numbered to allow them to be associated with the commands to which they apply. 
The numbers do not represent an error code, but are arbitrarily assigned for identification purposes. 

When more than one OCP command is entered on a line, and an error occurs, the command in error 
(or that caused the error) and all subsequent commands in the statement must be entered again. It is 
sometimes necessary to supplement the error message information with information obtained by 
executing other OCP commands (ST, SI, DM, DW, etc.) to determine which commands have 
executed correctly. System generation documentation provides information about the tasks actually 
in the system, their identifiers, and their priority levels. It is also helpful to enter the commands 
individually so that any error messages are printed following entry of the command. However, the 
user must exercise care to avoid reexecuting a command that executed correctly and will provide 
undesirable results if it is executed again. 

wneii LUi'NU l is assigiieu to a ucviuc uiai is un mic, ui wnon ljKjx^\j i is nui asaigiicu tuiu a 

command is used which generates a listing (DMEM,STASK,SIO), OCP ignores the command and 
prompts the user with a period(.). 
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Menage 

♦INVALID COMMAND* 



Table 3-2. OCP General Error Messages 
Meaning 

The command word is not valid. 



I/O ERROR, TERMINATED An I/O error was detected 

during reading of the command. 



OUTPUT ERROR 



An error was detected during 
output and execution of the 
command has been terminated. 



Recovery 



Check the command word, and 
reenter correctly. 

Input from the system console was 
not received correctly or the device 
timed out. 

This message is printed when LUNO 
1 has not been assigned. Check device 
for errors. 



UNDEFINED ERROR 



MISSING SYS MSG 



TX990 returned an error code to 
OCP that is not recognized by OCP. 



OCP could not locate the text for 
an OCP error message. 



This is a system error. Make another 
attempt to enter the command. If 
error reoccurs, reinitialize the 
system. 

OCP is incorrectly configured or 
incorrectly programmed. First verify 
that the proper OCP modules were 
linked with the system, and relink 
and reload the system if they were 
not. If all required modules were 
linked, and these modules were 
supplied by Texas Instruments, 
contact your Texas Instruments 
representative. If user-supplied 
OCP modules are involved, refer 
to error message information in 
paragraph 6.2.2 and verify the 
coding of the OCP module. 
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table 3-3. OCP Operand Error Messages 




Menage 

Number 

1 OPERAND ERROR (S) 



Meaning 



One or more operands are invalid. 



Recovery 



AppHeito 



LUNO IN USE 



Tltie LUNO is busy and cannot be re- 
leased or reassigned until the LUNO 
becomes available. 






BAD LUNO 



Not SYSTEM LUNO 



BAD DEVICE 



TABLE AREA FULL 



Invalid LUNO specification. 

A system LUNO cannot be reas- 
signed or released. 

Invalid device name. 



The table area used by the command 
is full. 



O 

<Q 

SL 

I 

CO 

5? 
§ 

5" 
o* 

31 



When a required operand has been i AL/RL, LP, 

omitted, enter the complete com- EX, DM, LM, 

mand. When a numeric operand is re- SB, CB, AD, 

quired, but a nonnumeric operand was SU, JM, KT, 

entered, enter the command with the KI, RE, FS» 

correct type of operand. BS, ID, DW, 

If a record mode I/O operation to the l AL, RL, LP. 

LUNO is in progress, enter the command 

again after the opertion has completed. 

If the LUNO is assigned to a file-oriented 

device, and has been opened, enter the 

command again after the LUNO has been 

closed. 

Enter the command with a valid LUNO, AL, RL. 
through FE 16 . 

Enter the command with the correct AL, RL. 

LUNO. When the system inludes OCP 
LUNO is a system LUNO. 

Enter the command with one of the iAL, LP. 

device names assigned when the system 
was generated. 

When the message entry of an ALIor LP i AL, LP, SB. 
command, release an unused LUNO, and 
enter the command again. Alternatively, 
generate a new TX990 that contains more 
LUNO blocks. When the message follows 
entry of an SB command, clear a break- 
point and enter the command again. 






Menage 

Numbtr 



Mesnge 



CHECKSUM ERROR 



Table 3-3. OCP Operand Error Messages (Continued) 

Meaning Recovery 



Checkium error occurred while 
reading load module. 



■ 

© 



I/O ERROR 



WONT FIT 



Error occurred while reading load 
module. 



The program being loaded is too 
large for the dynamic task area. 



a 

I 



O 

25" 
5" 

3 



10 



11 



CANT BID LOADER 



TASK RUNNING 



The loader module is currently in use 
or is not included in the system. 



A user task in the dynamic task area 
is currently executing. 



The device that reads the module is un- 
able to read a record accurately. The last 
record read is the record in error. Make 
another attempt to read the record, or 
obtain another module and load. This 
error is normal when a record of the 
object module has been modified without 
correcting the checksum of the record. 
To override the error, enter Ithe LP com- 
mand again without repositioning the 
medium on which the object module 
resides. 

Position the medium at the first record 
and enter the command again to read the 
module again, or obtain another module 
and load. 

The size of the dynamic task area is 
printed by ST ASK. To execute a task 
larger than that size, increase the size of 
the dynamic task area by relinking the 
system with fewer modules or by increas- 
ing the size of memory. 

When current loading has been com- 
pleted, enter She command again. If the 
loader is not in the system, relink the 
system to include the loader. 

When the task completes execution, enter 
the command again. Alternatively, enter 
a KTASK command to force termination 
of the task, and enter the command again. 




Applies to 



LP. 






LP. 



LP. 



LP. 



I LP. 



Message 
Number 

12 



Message 
NOT FOUND 



13 



ALREADY SET 






14 



NOT JMP $ 



15 



OUT OF RANGE 



I 

0) 

3 

CO 



5" 



16 

17 



NOT RUNNING 
BADLUNO 



Table 3-3. OCP Operand Error Messages (Continued) 
Meaning 




The specified task cannot be found. 



A breakpoint has already been set 
at this location, or the location con- 
tains a JMP $ instruction. 



The location had a breakpoint set 
but does not contain a JMP $ instruc- 
tion. Contents of the location are not 
altered, but breakpoint is removed 
from the table. 

The address in the second operand 
cannot be reached with a JMP instruc- 
tion. 



The specified task is not running. 

The specified LUNO is invalid or not 
assigned. 



Recovery 



Applies to 



EX, CB, KT, 
DW. 



When the task cannot be found because 
the user has entered the identifier incor- 
rectly, enter the command with the cor- 
rect identifier. When the identifier is 
correct, but the task was not identified 
to the system or linked to the system, 
generate and/or link the system correctly. 

When the breakpoint was previously set, SB. 
the command does not need to be entered 
again. When the location contains JMP $ 
in error, enter the correct instruction with 
an LMEM command. When the JMP $ 
instruction is the correct contents, no 
further command is required. However, the 
task will not execute beyond that point. 

The JMP $ instruction has been overlayed CB. 
as a result of a programming error or by 
loading a new task without clearing active 
breakpoints. Enter a LMEM command to 
correct the contents if not correct. 

Use another instruction or combination JM. 
of instructions instead of a JMP instruc- 
tion. Alternatively, reorder the segments of 
code so that the destination of the instruc- 
tion is within the range of a JMP instruc- 
tion. 

No recovery necessary. KT. 

Enter the command again with the cor- RE, FS, BS. 
rect LUNO. If in doubt about LUNO 
assignment, enter an SIO command. 



* 

■ 

--a 

o 






Message 
Number 

18 



19 



20 



21 



22 



Message 



Table 3-3. OCP Operand Error Messages (Continued) 
Meaning 



RESOURCE NOT AVAILABLE The specified LUNO is assigned to a 

task. 



END-OF-FILE 



ID IN USE 



NO! TASKS ATTACHED 



BAD ID 



An EOF was detected during the 
requested operation. 

The task or procedure ID specified 
is already used. 

The procedure being deleted has 
tasks attached. 

An invalid task ID or attached 
procedure ID was selected. 



Recovery 



When the task has completed, enter the 
command again. Alternatively, enter a 
KTASK command to force termination 
of the task and enter the command 
again. 

The operation ceases when the EOF is 
detected. No recovery necessary. 

Select another ID. 



Delete the attached tasks. 



Select another ID. 



Applies to 
RE,FS,BS. 



FS, BS. 
IT, IP. 
DP. 
IT. 



I 
I 

0) 

s 

§ 

5* 
8' 
6' 

3 
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SECTION IV 
CONTROL PROGRAM 

4.1 INTRODUCTION 

The TX990 Control Program provides a simple interface which allows a terminal operator/user to 
load and execute programs. It can also be used to pass parameters to a program being executed. The 
following paragraphs describe how to use the Control Program, as well as the mechanism used to 
pass parameters to initiated tasks (programs). 

4.2 ACTIVATING AND DEACTIVATING THE CONTROL PROGRAM 

The Control Program, like OCP, may not be executed unless it is linked in with the TX990 
operating system. Activation of the Control Program is different between systems which include 
OCP and systems which do not. 

In an operating system which does not include OCP, the control program is activated by entering an 
exclamation point (!) at an terminal. 

In a system which does include OCP, the Control Program must be activated through OCP: 

1. Enter ! at a terminal, activating OCP. 

2. Respond to the OCP command prompt (i) as shown: 

.EX, 16. TE. 

3. The above command executes task 16 16 (the Control Program) and terminates OCP. 

After the Control Program is executed, the following printout or display is presented at the system 
console: 

Tvno ni/-tir ** 1 en Inn i.nc 

1AUO yjozu 1JZ,/// l.UJ 

PROGRAM: 

The previous display tells the operator that the Control Program is in execution and that the 
operator may respond to the PROGRAM: prompt by specifying the program to be loaded and/or 
executed. The display heading indicates the name of the monitor (TXDS), the part number of the 
software, the revision status (** = no revision, *A = 1st revision, *B = 2nd revision, etc.), and the 
date and time of day that the program was loaded (152/77 = 152nd day of 1977). 

The Control Program may be terminated by entering only a carriage return in response to the 
PROGRAM: prompt. 

4.3 LUNOs 

The Control Program assigns LUNO 2 to a pathname given in response to the PROGRAM : prompt 
(i.e., the file or device from which the desired program is to be loaded). 
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4.4 OPERATOR INTERACTION 

The Control Program assists in program loading and execution by printing out or displaying 
prompts on the system console, sequentially, as follows: 

PROGRAM 

INPUT 

OUTPUT 

OPTIONS 

The following paragraphs describe the prompts and user responses. 

4.4.1 PROMPT RESPONSES. The Control Program prompts the user to enter the program 
pathname, input pathname, output pathname, and option-selections. ID or It checks each pathname 
for syntax. If the syntax is not correct, it will prompt the user again. After all of the responses to 
the prompts are entered, the Control Program loads and/or executes the specified program. 

4.4.1.1 PROGRAM: Prompt. The operator's response tp the PROGRAM: prompt is used for 
specifying either the pathname of the file containing the program to be loaded and executed, or the 
ID of a program in memory. 

Only one pathname can be entered in response to the PROGRAM: prompt. When the program is to 
be loaded as a privileged task (enabling the task to execute certain supervisor calls), the user must 
enter the pathname followed by a ",P". A task, when not linked with the operating system, can be 
made privileged when it is loaded or by issuing a Make Task Privileged SVC at execution. All tasks 
linked with TX990 are privileged. When the task is loaded, it is assigned task ID 10 16 . 

Should the user desire to execute a task already in memory, the task ID, preceded by a hexadecimal 
sign (>) must be entered in response to the PROGRAM: prompt. For example, after the TXEDIT 
utility program has been loaded into memory, it can be reexecuted as follows: 

TXDS 936215 ** 010/77 2:05 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



>10 

DSC:TASK2/SRC 
DSC: SCRATCH/SRC 

(carriage return) 



4.4.1.2 INPUT: Prompt. The operator's response to the INPUT: prompt is used to specify the 
pathname(s) of input information needed by the program during its execution. The operator can 
enter zero to three input pathnames separated by commas. The Control Program will check each 
parameter for syntax. If the syntax is wrong, the Control Program will prompt the user again. The 
user must enter the entire line again. 

4.4.1.3 OUTPUT: Prompt. The operator's response to the OUTPUT: prompt is used to specify the 
pathname for storage of the output information resulting from execution of the program. Up to 
three pathnames (separated by commas) can be entered in response to the OUTPUT: prompt. 

4.4.1.4 OPTIONS: Prompt. The operator's response to the OPTIONS: prompt is used to specify 
the option(s) selected from the total alternative options available for the program which is to be 
loaded and executed. 
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4.4.2 DEFAULT VALUES. Except for the PROGRAM: prompt, default values for the Control 

Program prompts are determined by the program being executed. 

If the user intends to execute a task already in memory without reloading it, he must enter the task 
ID; no default value is allowed. 

If the user intends to load the program from a device (not a file), the device name must be specified 
(i.e., there is no default value). If a file pathname is entered (see Section I on pathnames), the user 
may leave both the device/volume name and the file extension fields unspecified. 

When a PROGRAM: pathname does not specify the diskette volume name or drive, the Control 
Program starts a device-file search beginning with the diskette drive that is the default-substitute 
defined during system generation. For a standard Tl-supplied system, the default-substitute is DSC. 
If the file is not on the diskette of the first default diskette transport drive, the Control Program 
will concatenate a 2 to DSC and the file search would then proceed to DSC2. In the same manner, 
the search continues to DSC3 and to DSC4. The search is only effective when the diskette 
default-substitute is the main diskette drive and when its device-name identifier is comprised of 
three characters, (i.e., DSC or any other three characters). It should also be noted that whenever the 
user specifies the device-name identifier in response to the PROGRAM: prompt, only the specified 
device (e.g., the specified diskette transport drive) is searched. 

When the user enters only a slash (/) as the extension field in the PROGRAM: prompt pathname, 
the extension will default to SYS and SYS will be substituted into the pathname before any drives 
are searched. If neither the extension nor a slash is entered, the extension is assumed to be blanks. 

4.4.3 SPECIAL KEYBOARD CONTROL KEYS. The special keyboard control keys are described 
as follows: 



1 . RUB OUT/DELETE LINE 



2. CONTROL H/Back Arrow 



3. Carriage Return/NEW LINE 



4. ESCAPE/RESET 



Allows the operator to reenter a parameter. 
Pressing the RUB OUT key causes a line feed 
followed by a carriage return. The operator may 
then enter the line again. 

Allows the operator to backspace by character 
and correct a typing error. 

Causes TXDS Control Program to terminate if 
the carriage return or NEW LINE was the only 
entry in response to the PROGRAM: prompt, 
otherwise terminates a prompt line entry. 

If an ESCAPE or RESET is entered during a 
print out, the TXDS Control Program 
terminates. 



& 



Causes a default to be activated when entered as 
the response to the INPUT: or OUTPUT: 
prompts. 

In any prompt line, pressing the & key as the 
first character in the response causes the TXDS 
Control Program to restart with the PROGRAM: 
prompt. 
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7- * When entered after a prompt line entry, in place 

of a carriage return, permits the next prompt 
line to be entered without being prompted by 
the TXDS Control Program. When a prompt line 
is terminated with an asterisk (*) followed by a 
carriage return, no more prompts are given and 
default-substitutes are made by the utility 
program for those pathnames not entered. The 
experienced user can enter all or several of the 
parameters on one prompt line. 

The following examples utilize the asterisk (*) feature in lieu of the INPUT:, OUTPUT- and 
OPTIONS: prompts: 

Example 1: 

To load the TXEDIT utility program after the TXDS Control Program has been loaded, the 
asterisk (*) is used as presented in the following example: 

TXDS 936215 ** 010/77 2:05 

PROGRAM: DSC:TXEDIT/SYS*DSC:TASK2/SRC*DSC:SCRATCH/SRC* 

(where DSC:TASK2/SRC is the INPUT: pathname; DSC: SCRATCH/SRC is the OUTPUT: 
pathname; and the OPTIONS: entry is provided by the default-substitution specified in the 
TXEDIT utility program.) 

The above can also be entered as follows: 

TXDS 936215 ** 010/77 2:05 

PROGRAM : DSC : TXEDIT/S YS 

INPUT: DSC:TASK2/SRC*DSC:SCRATCH/SRC* 

Example 2: 

To load the SYSUTL utility program after the TXDS Control Program has been loaded, the 
asterisk (*) is used as follows: 

TXDS 936215 ** 101/77 ,2:05 

PROGRAM: :SYSTUL/SYS***CF,: TEMP/OBJ 

(where the INPUT: and OUTPUT: parameters are null and the OPTIONS: parameter is 
CF,:TEMP/OBJ.) 

NOTE 

1. In the above examples, it is necessary to press the carriage 
return key at the end of the parameter line to cause the 
program to be loaded and executed. 
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2. If a parameter line ends with an asterisk (*) and a pathname is 
not entered for each prompt, then default substitutes are made 
by the utility program for those pathnames not entered. 



Example 3: 



The following example utilizes the comma (,) to cause a default-substitution to be made in the 
OUTPUT: pathname below. 

TXDS 9326215 ** 010/77 2:05 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



:TXMIRA/SYS 
:TASK1 
,CRT 
M800,X,L 



(where the OUTPUT: pathname defaults to a substitute specified in the TXMIRA Assembler 
utility program.) 

lie following example utilizes both the asterisk (*) and the comma (,) special keyboard controls: 

To load the TXMIRA Assembler utility program after the TXDS Control Program has been 
loaded, the asterisk (*) is used as follows: 

TXDS: 936215 ** 010/77 2:05 



PROGRAM: :TXMIRA/SYS*:TASK1*,CRT*M8Q0,X,L 

(where TASK1 is the INPUT: pathname and where the OUTPUT: 
default-substitute provided in the TXMIRA Assembler utility program.) 



pathname is the 



4.5 ACCESSING PARAMETERS THROUGH THE CONTROL PROGRAM 

The responses to the prompts of the Control Program are entered into a block of memory known as 
/-"/-vn/TA/r/^xT ~,~,~,~-x, TUa tooU nrViiWi ic Vkoinrr IoqHpH QnH PYPPntprl tlipn acppssps COMMON memorv 

for the information contained in these responses. The response-information is stored in the bytes of 
COMMON memory in an organized nammer using the format presented in table 4-1. The 
programmer, when coding a user utility program or a user applications program, will find it 
necessary to become familiar with the format of COMMON memory. Access to the 
response-information in COMMON memory is provided to the programmer by the use of Get 
COMMON Data supervisor call 10 16 (see Section 6). Get COMMON Data returns the memory 
address and the byte-size of COMMON to the task. The Control Program can only execute in an 
operating system which was generated with at least 170 bytes of COMMON memory. The user must 
take this into consideration when performing system generation. 

A typical example of an operator's response-entries to the TXDS Control Program's prompts is 
presented below, immediately followed by the hexadecimal and ASCII representation in binary 
code of the operator's response that is placed in the COMMON memory block. 

TXDS 936215 *A 010/77 2:05 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



TXLINK/ 
TXTST,/,CS1 
TXTST2/OBJ,LP 
ITXT,M4000 
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Parameter 
PROGRAM: 



Table 4-1. Byte-Allocation of COMMON Memory 
Byte(s) Explanation 



0-15 



To be coded with the same pathname information that is 
entered in response to a PROGRAM: prompt. 



NOTE 

The response-entries to the PROGRAM:, INPUT:, and OUTPUT: prompts are 
placed in byte-groups of 16 bytes each. The device name is entered in the first four 
bytes, left-justified, and space-filled with zeros. A colon is placed in the fifth byte if 
the program name is a diskette file name; otherwise a binary zero is placed in the 
fifth byte. The file name is entered in the sixth through twelfth bytes, left-justified, 
and space-filled with binary zeros. A slash is placed in the thirteenth byte when a 
diskette file is to be referenced by the pathname being entered; otherwise a binary 
zero is placed in the thirteenth byte. The extension is placed in the fourteenth 
through sixteenth bytes, left-justified, and space-filled with binary zeros. Whenever 
the device, file, or extension is to be defaulted by the utility or the user's task, the 
binary field relating to the device, file, or extension will be space-filled with binary 
zeros. When the total parameter (which includes the device, file, and extension 
fields) is defaulted, a colon (:) is placed in the fifth byte and a slash is placed in the 
thirteenth byte and all the fields become space-filled with binary zeros. 



INPUT: #1 



INPUT: #2 



INPUT: #3 



16-31 



3247 



48-63 



OUTPUT: #1 64-79 



OUTPUT: #2 80-95 



OUTPUT: #3 96-111 



OPTION: 



112-143 



To be coded with the same pathname information that is 
entered for the first INPUT: parameter. 

To be coded with the same pathname information that is 
entered for the second INPUT: parameter. 

To be coded with the same pathname information that is 
entered for the third INPUT: parameter. 

To be coded with the same pathname information that is 
entered for the first OUTPUT: parameter. 

To be coded with the same pathname information that is 
entered for the second OUTPUT: parameter. 

To be coded with the same pathname information that is 
entered for the third OUTPUT: parameter. 

To be coded with the character-entries that the operator 
entered in response to the OPTIONS: prompt. The charac- 
ters entered in response to the OPTIONS: prompt will be 
copies into 1 12-143. Up to 30 characters can be entered 
and copied into COMMON memory and following the last 
character entered is a binary zero. 
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Table 4-1. Byte-Allocation of COMMON Memory (Continued) 



Chaining 
Pathname 



144-1 59 Used for the chaining pathname, which is the pathname of 

the next program to be loaded and executed if the chaining 
flag in byte 160 is set to a nonzero number. The chaining 
pathname is initialized so that the first four bytes each have 
a binary zero, the fifth byte has a colon, the sixth through 
twelfth bytes each contain a binary zero, the thirteenth byte 
contains a slash, and the fourteenth through sixteenth bytes 
each contain a binary zero. 



Chaining 
Flag 



160 



This is the chaining flag byte which is set to a nonzero number 
by a user program or a utility program when it is desired to 
chain from the end of one program to the pathname specified 
in bytes 144-159. The object program which is at the path- 
name specified in bytes 144-159 is then loaded and executed. 
One program (a user's task or TXDS utility program) can 
chain to another by setting the chaining flag in memory 
(byte 160), placing the access name (i.e., the chaining path- 
name) for the new program in bytes 144-159 and executing 
an End-of-Program 16 16 supervisor call. The INPUT: 
OUTPUT:, and OPTIONS: prompts can be used as required 
to pass parameters to the new program. 



Batch Mode 
Flag 



161 



Set if batch job control stream is in progress. The TXDS 
Control Program loads and executes the object program 
which is in the pathname specified in bytes 144-159. 



Batch 
Error 



162 



Set when a program terminates in error during a batch 
stream. 



Chaining 
Error 



163 



Chaining Error Flag. Set when the program chained to termi- 
nate is in error. 



Default 
Print 



164-167 Default system console print device declared at time of system 

generation. 



Reserved 



168-170 



Reserved for later enhancements. 
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The above responses to the prompts are placed into the COMMON memory block as follows: 



Byte 
Address 

0-15 



16-31 



32-47 



48-63 



64-79 



80-95 



Hexadecimal Representation (Upper Row) 
and ASCII Representation (Lower Row) 



0000 


0000 


3A54 
: T 


584C 
X L 


494E 
I N 


4B00 
K . 


2F00 

/ • 


0000 


0000 


0000 


3A54 
: T 


5854 
X T 


5354 
S T 


0000 


2F20 
/b = 


0000 


0000 


0000 


3A00 


0000 


0000 


0000 


2F00 

/ • 


0000 


4353 

c s 


3100 

1 . 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


3A54 
: T 


5854 
X T 


5354 
S T 


3200 

2 . 


2F4F 

/ o 


424A 
B J 


4C50 
L P 


0000 


0000 


0000 


0000 


0000 


0000 


0000 



96-111 



0000 



0000 



3A00 



0000 



0000 



0000 



2F00 



0000 



112-143 



4954 
I T 



5854 
X T 



2C40 
, M 



3430 
4 



3030 




UNDEFINED 



144-159 



0000 



0000 



2A00 



0000 



0000 



0000 



2F00 



0000 



160 



00 



161 



00 



162 



00 



163 



00 



164-167 



168-n 



4C4F 4720 

L G 



This assumes that LOG was defined as system 
default print device during system generation. 

Not used. 
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4.6 ERROR MESSAGES 

Refer to table 4-2 for a list of error messages, the reason for each error, and the recovery method. 



Error 

nn-BAD PGM LOAD 



Table 4-2. TXDS Control Program Error Messages 

Reason 

nn represents error code 
listed in error appendix D. 



-BAD PGM LOAD 
nn-CAN'T BID TASK 



CAN'T GET COMMON- 
ABORTED 



Can't find object file. 

nn represents the task state 
code of task 10 16 listed in 
state code appendix C. 

System was configures without 
COMMON. 



Recovery 

Reenter parameter 

Reenter parameter 
Reenter parameter 



Configure a system 
with 168 bytes of 
common 
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SECTION V 
PROGRAMMING TASKS 



5.1 INTRODUCTION 

A program that executes under the TX990 operating system is also referred to as a task. The task 
consists of a data division and a procedure division. These divisions may be assembled as a single 
module or as two or more separate moauies unitea to form a smgie ooject moauie. ine siruciure ot 
a task is described in this section. 

This section also includes a description of the programming considerations for writing tasks to be 
executed under TX990, and detailed descriptions of the supervisor calls by which a user task 
requests the support of TX990. Also included is a description of task scheculing. 

5.2 TASK STRUCTURE AND PROGRAMMING 

Logically, a task consists of a data division and a procedure division. Figure 5-1 shows the task 
structure supported by TX990, and the relationship of the first three words of the task to the data 
and procedure divisions. The data division contains the workspaces required by the task and all 
other data structures (tables, supervisor call blocks, buffers, constants, etc.). The procedure division 
contains the executable code for the task. When the task is assembled as a single module, the logical 
division of the task into a data division and a procedure division is optional; however, the task 
should be organized so that the procedure division may be shared with other tasks should it become 
desirable. 



WORD 



WORD 1 



WORD 2 



INITIAL WP CONTENTS 



INITIAL PC CONTENTS 



END ACTION ADDRESS 



DATA DIVISION 



WORKSPACE 



PROCEDURE DIVISION 



(A)1 33423 



Figure 5-1 . TX990 Task Structure 
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When a procedure division is shared with several data divisions, each combination of a data division 
with the procedure division is a separate task. The procedure division must be reentrant in this case. 
General requirements of reentrant programming are described in the Model 990 Computer 
TMS9900 Microprocessor Assembly Language Programmer's Guide, part number 943441-9701. In 
addition to those requirements, TX990 requires that addressing of data in the data division by the 
instruction in the procedure be indexed addressing. The user must place the data-division address in 
one of the workspace registers when the data division is assembled and use this register to index 
addresses in the procedure. 

The user may resolve the addressing problems of a procedure being shared by more than one task in 
either of two ways. The user may include the dummy origin directive when assembling the 
procedure, making the data-division relative addresses available to the procedure. Alternatively, the 
user may link the data divisions and the procedure division. This will result in multiple definitions. 
The definitions must be identical, if the procedure is to be shared. Therefore, whichever of the 
multiple definitions is used by the link editor, the result will be correct and the multiple definition 
messages may be ignored. Any of the tasks that share a procedure may be executed in the dynamic 
task area. This can be done by linking the data division, for that task to the common procedure 
division, and loading the task into the dynamic-task area. 

The first three words of the data division contain the addresses of the initial workspace, the 
procedure entry point, and the end action entry point, respectively. The contents of the first word 
are placed in the WP register when the task begins execution. The user places the address of the 
initial workspace (16-word memory area accessible as 16 workspace registers) in that word. The 
second word contains the address of the entry point to the procedure division, which is placed in 
the PC when the task begins execution. The third word controls end action. When the value in the 
third word is greater than 15, the value is interpreted as the address of an end action routine, 
described in greater detail in paragraph 5.5. When the value is 15 or less, this value has no 
significance other than to indicate that no end action is to be taken. 

In addition to dividing a task into data and procedure divisions, the user may make parts of the task 
into overlays, using the Link Editor. TX990 supports the automatic overlay loading capability of 
the Link Editor, as described in the Model 990 Computer Link Editor Reference Manual, part 
number 949617-9701. 

Briefly, to create an overlayed program the user should assemble each intended overlay as a separate 
module, placing the output from the assemblies into separate files. All calls to overlay modules must 
be Branch and Load Workspace Pointer (BLWP) instructions, with the entry point of the overlay as 
the operand (no indexing or register operand is allowed). Next, the program must be linked, using 
the Link Editor. The user specifies the overlay structure of the problem through various link editor 
commands. The link editor LOAD directive must be used, to notify the Link Editor that automatic 
overlay loading is desired. See the Link Editor Reference Manual for more explanaiton of overlayed 
programs and usage of the Link Editor. 

5.3 TASK SCHEDULING 

The task scheduler uses a priority scheme with four levels and maintains a list of active tasks at each 
priority level. A task is added at the end of the active list in each of the following cases: 

• When the task is placed in execution (bid). 

• At the completion of a time slice. 
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A time slice is a period of execution of a task, beginning when the scheduler passes control to the 
task. A time slice ends when any of the following occurs: 

• The system suspends the task upon expiration of the maximum time period allowed for a 
time slice. 

• The task executes a supervisor call that suspends the task. 

• The system suspends the task to await completion of an I/O operation. 

The maximum time period allowed for a time slice is a system parameter specified when the system 
is generated. 

When the currently executing task completes a time slice, the task scheduler passes control to the 
oldest task on the active list for the highest priority (0). If there is no task on the active list for 
priority 0, the oldest task on the active list for the next highest priority receives control. 

To avoid completely locking out low priority tasks, there is a maximum number of consecutive time 
slices (weighting factor) for each priority level. When this number of time slices has been used by a 
priority level, the oldest task on the active list for the next lower priority is allowed a time slice 
before the higher level again has control. The maximum number of time slices for each priority level 
are system parameters defined during system generation. 

Task management maintains a state code for each task. The state codes are listed in Appendix G. 

5.4 PREVENTING ACCIDENTAL ALTERATION OR DESTRUCITON OF THE OPERATING 
SYSTEM 

The most important consideration in programming user tasks is that the tasks do not interfere with 
the proper operation of the operating system. TX990 executes in either the Model 990/4 or the 
Model 990/ 1 Computer. Programming considerations to prevent accidental alteration or 
destruction of the operating system are different in each model. 

In the Model 990/10 Computer, user tasks may execute in either the privileged or nonprivileged 
mode. An attempt to . execute any of the following assembly instructions (described in the 
Model 990 Computer TMS 9900 Microprocessor Assembly Language Programmer's Guide part 
number 943441-9701) in the nonprivileged mode will result in a fatal error: 

RSET 

IDLE 

CKOF 

CKON 

LREX 

SBO, when the effective CRU address is E00, 6 or greater 

SBZ, when the effective CRU address is E00 16 or greater 

TB, when the effective CRU address is E00 16 or greater 
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LDCR, when the effective CRU address is E00 16 or greater 

STCR, when the effective CRU address is E00 16 or greater 

LIMI 

LMF (only available in computers having map option) 

LDS (only available in computers having map option) 

LDD (only available in computers having map option) 

Although privileged and non-privileged modes are not used in the Model 990/4 Computer, generally, 
the user should avoid using the above instructions. If necessary the user may execute some of the 
above instructions with care; however, the system may operate improperly or fail to operate. 

Execution of an RSET instruction has unpredictable results. Execution of an IDLE instruction 
places the computer in the Idle mode until an interrupt occurs. The CKOF and CKON instructions 
control the real-time clock, which is used by the system to allot execution times to tasks according 
to the scheduling algorithm. A CKOF instruction must not be executed, and a CKON instruction 
should not be required. Execution of an LREX instruction transfers control of the program that 
controls the programmer panel, stopping system operation. Execution of an LIMI instruction may 
interfere with the system control of interrupts. An LIMI instruction with an operand of inhibits 
all interrupts. This instruction is permissible if the user reenables interrupts by executing an LIMI 
instruction having an operand of 1 5 as soon as possible. A user task should use the Do Not Suspend 
supervisor call to inhibit suspension of the task at the end of the current time slice rather than an 
LIMI instruction. Integrity of system time is lost if interrupts are not reenabled within 8.3 ms 
(60-Hz line frequency) or 10 ms (50-Hz line frequency). 

The operating system uses the higher-order Communications Register Unit (CRU) addresses for 
dedicated purposes. None of the CRU instructions (SBO, SBZ, TB, LDCR, or STCR) should access 
any CRU addresses greater than DFF 16 . For example, if workspace register 12 contained 1BF0 16 
as the CRU base address, an SBO instruction with a displacement of 8 results in an effective CRU 
address of E00i 6 , a dedicated address. Displacements less than 9 would result in valid addresses. 
The same base address in workspace register 1 2 would result in accessing dedicated addresses if an 
STCR instruction to store 8 or more bits were attempted. Refer to the Model 990 Computer 
Assembly Language Programmer's Guide, part number 943441-9701, for details of CRU addressing. 

The user may write routines to perform extended operations (XOP). For tasks executing under 
TX990 in a Model 990/4 Computer, the same restrictions to the use of instructions apply both in 
the task and in the XOP routine. For tasks executing under TX990 in a Model 990/10 Computer, 
the restrictions that apply to the Model 990/4 Computer apply also in the XOP routine in the 
Model 990/10 Computer, because the Model 990/10 Computer is placed in the privileged mode by 
execution of an XOP instruction. Additional information about programming extended operations 
is included in Appendix C, entitled "User-Supplied Modules". 

5.5 USER-SPECIFIED END ACTION ROUTINE IN RESPONSE TO FATAL ERRORS 

The user specifies end action by placing the address of an end-action routine in the third word of 
the user task. When TX990 detects a fatal error and terminates the task abnormally, control 
transfers to the address in the third word unless that word initially contained a value of 15 or less. 
This allows the user to supply a routine to perform any required terminating function. 
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TX990 places the appropriate error code in the third word of the task after obtaining the end action 
routine address. After performing end action, or when the error is detected and no end action is 
specified, TX990 releases all I/O devices, closes all files, and removes the task from execution. The 
task error codes are listed in Appendix H, entitled "Printout of Fatal Task Error Codes and Illegal 
Interrupt Code". 

When a task that has taken end action is to be reexecuted without reloading, the end-action routine 
must restore the end-action-routine address in the third word of the task. 

5.6 CODING SUPERVISOR CALLS AND SUPERVISOR CALL BLOCKS 

A user task requests support of the operating system by executing a supervisor call, XOP Level 15. 
A supervisor call block contains one or more bytes that define the supervisor call. The first byte of a 
supervisor call block contains the code of the supervisor call. Subsequent bytes are used as described 
for specific supervisor calls, when required. 

The supervisor call may be coded in either of two ways. The first example shows a supervisor call 
coded as an XOP instruction: 

XOP @SCBA,15 Perform extended operation 15, by passing the 

address corresponding to @SCBA to the system. 

Alternatively, a symbol may be defined for supervisor calls using DXOP directive, as follows: 

DXOP SVC, 1 5 Define symbol SVC for extended operation 1 5. 

Supervisor calls following that directive may use the defined symbol, SVC, in the operation field 
and the address of the supervisor call block in the operand field as follows: 

SVC @SCBA Perform extended operation 15 using the supervisor 

call block at address @SCBA. 

Supervisor call blocks are coded using BYTE directives, DATA directives, or both. Some supervisor 
call blocks must be aligned on word boundaries (i.e., they must have even addresses). Use of a 
DATA directive assures word alignment, but a BYTE directive does not perform word alignment. 
The descriptions of supervisor calls in the previous paragraphs identify the supervisor call blocks 
that must be word-aligned. 

The following examples show coding for supervisor call blocks: 

SCBA BYTE > 10,0 Place 10 16 , the code for a Get Common Data Address 

supervisor call, in a byte at location SCBA. The second 
byte contains 0. 

SCBB DATA >0300,DTBUF Place 03 16 , the code for a Get Date and Time supervisor 

call, in the first byte of a two-word block at location 
SCBB, a word boundary. The second byte of the block 
contains 0, and the last two bytes contain the address 
corresponding to location DTBUF, a five-word buffer into 
which the function places the date and time. 
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Alternatively, the label for a supervisor call block may be supplied with an EQU directive, as 
follows: 

SCBB EQU $ 

DATA <300,DTBUF Assign label SCBB to current location. Place 03 in the first 

byte of a two-word block and the address corresponding to 
location DTBUF in the second word of the block, as in the 
preceding example. 

The preceding example produces the intended result only if the current location is a word-aligned 
location. When the statements in the example follow a BYTE directive or a TEXT directive the 
location may not be word-aligned, and, if it is not, SCBB will not be the address of the supervisor 
call block. The following example will provide the desired result: 

SCBB EVEN 

DATA <0300,DTBUF If the location is not word-aligned, increment the location 

to a word boundary and assign label SCBB to the result. 
Otherwise, assign label SCBB to the location. Build the 
supervisor call blocks as in the preceding example. 
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SECTION VI 
EXECUTIVE SUPERVISOR CALLS 



6.1 INTRODUCTION 

Executive supervisor calls (SVCs) in the TX990 operating system provide the user with the ability 

to control activities/operations in the user program, and to request services from the operating 
system. Table 6-1 shows the executive supervisor calls provided by TX990. 

Table 6-1 . Executive Supervisor Calls 

SVC Name Hexadecimal 

SVC Code 

Bid Task 5 

Change Priority 1 1 

Do Not Suspend 9 

Time Delay 2 

Activate Time Delay E 

Unconditional Wait 6 

Activate Suspended Task 7 

End-of-Task 4 

End-of-Program 16 

Get Parameters 17 

Get Own ID 20 

Make Task Privileged 23 

Convert Binary to Decimal A 

Convert Decimal ASCII to Binary B 

Convert Binary to Hexadecimal ASCII C 

Convert Hexadecimal ASCII to Binary D 

Get Memory 1 2 

Release Memory 1 3 

Get System Table 21 

Get COMMON Data 10 

Return COMMON Data IB 

Put Data 1C 

Get Data ID 

Date and Time 3 
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6.2 TASK CONTROL SUPERVISOR CALLS 

Task control SVCs are used to schedule and control the execution of tasks. These SVCs are 
discussed in the following paragraphs. 

6.2.1 BID TASK SUPERVISOR CALL 5 16 . Bid Task supervisor call 5 16 activates the specified 
task. The supervisor call block contains three, six, or eight bytes, aligned on a word boundary. Byte 
contains the code, and the system returns a value in byte 1. Byte 2 contains the task identifier 
assigned to the task being bid. If the task is a linked-in task, the task ID was assigned during system 
generation. In systems supporting multiple dynamic tasks, the ID of a dynamic task is assigned by 
the IT OCP command. In single dynamic task systems, the task identifier of the task in the dynamic 
task area is 10 16 . Byte 3 is unused. Bytes 4 through 7 may contain parameters to be passed to the 
task. The task obtains the parameters by executing a Get Parameters supervisor call. 

When the system is unable to locate the specified task, it returns a -1 in byte 1 of the supervisor call 
block. Otherwise, the system returns the current task state code in that byte. The task state code 
for a terminated task is 4. Other task state codes are listed in Appendix G. When the task state code 
is not equal to 4, the supervisor call is ignored. 

Bid task call block: 

o 

2 
4 

6 
(A)137478 

The following are examples or coding for supervisor call blocks for Bid Task calls: 

SCBB DATA >0500,>1000,>4845,>4C50 Supervisor call block for a Bid Task call to bid 

task 10 16 , and pass the ASCII representations 
of characters HELP to the task. 



5 


ERROR CODE 


TASK ID 


RESERVED 


BID PARAMETER 1 


BID PARAMETER 2 



SCBA DATA >0500>1A00 Supervisor call block for a Bid Task call to bid 

task 1A 16 . Undefined data from bytes corres- 
ponding to bytes 4 through 7 of the supervisor 
call block is passed to the task as parameters. 

6.2.2 CHANGE PRIORITY SUPERVISOR CALL 11 16 . Change priority supervisor call 11 16 
changes the priority of the calling task to a specified value. The supervisor call block contains two 
bytes and need not be aligned on a word boundary. Byte contains the code, and byte 1 contains 
the new priority value. The valid priority levels are through 3 (0 is usually reserved for system 
tasks). The system returns the previous priority value in byte 1. When the priority level is not 
through 3, the previous priority level is not altered, and the system returns -1 in byte 1. The 
system returns the previous priority value in byte 1 . 



Change priority call block: 



"16 


PRIORITY 



(A)137479 

The following is an example of coding for a supervisor call block for a Change Priority call: 



SCBP BYTE > 11,1 



Change the priority of the calling task to 1 . 
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6.2.3 DO NOT SUSPEND SUPERVISOR CALL 9 16 . Do Not Suspend supervisor call 9 16 causes 
the system to override the time slice for the calling task by inhibiting the system from suspending 
the task. The task may suspend itself by executing an I/O supervisor call, or a Time Delay, Wait for 
I/O, or Unconditional Wait supervisor call. The supervisor call block contains two bytes, and need 
not be aligned on a word boundary. Byte contains the code, and byte 1 contains or a positive 
number. When byte 1 contains 0, the task will not be suspended for a system time unit. When 
byte 1 contains a number, the task will not be suspended for that number of system time units. 
Suspension of a task may be inhibited for a period from 1 to 255 system time units. 

The length of a system time unit is dependent on the power-line frequency. For 60-Hz power, the 
system time unit is 50 ms. For 50-Hz power the system time unit is 40 ms. 



9 


NUMBER OF SLICES 



Do not suspend call block 

(A)1 37490 

The following is an example of coding for a supervisor call block for a Do Not Suspend call: 
SCBI BYTE 9,5 Inhibit suspending of calling task for five system time units. 

The Do Not Suspend supervisor call should be used instead of an LIMI instruction having an 
operand of zero to inhibit suspension of a task at the end of the current time slice. When a task 
manipulates a data structure that is used by several tasks, the task should complete its alterations 
to the data structure before any of the tasks that use the data execute again. The Do Not Suspend 
supervisor call allows such a task to lock out other tasks while changing the data. 

6.2.4 TIME DELAY SUPERVISOR CALL 2 16 . Time Delay supervisor call 2 16 suspends the calling 
task for a specified time period. The supervisor call block contains four bytes, aligned on a word 
boundary. Byte contains the code, and byte 1 contains zero. Bytes 2 and 3 contain the number of 
system time units during which the task is to be suspended. The range of time-delay-suspension 
periods is from 1 to 32,767 system time units. When a negative number is used, the task is 
suspended for 1 system time unit. The system time unit is defined in the preceding paragraph. 



t: j_i __n i.i i_. 

nine uciay uan uiuuk. 





NUMBER OF TIME UNITS TO DELAY 



(A)137481 

The following example shows coding for a supervisor call block for a Time Delay call: 

SCBT DATA >200,40 Suspend the calling task for 40 system time units. 

6.2.5 ACTIVATE TIME DELAY TASK SUPERVISOR CALL E 16 . Activate Time Delay Task 
supervisor call E 16 activates the specified task if it is in the time delay state. The supervisor call 
block contains three bytes, and need not be aligned on a word boundary. Byte contains the code, 
and the system returns a value in byte 1. Byte 2 contains the task identifier assigned to the task. 

When the system is unable to locate the task in the system, it returns -1 in byte 1 of the supervisor 
call block. Otherwise, the system returns the current task state code in that byte. The task state 
code for a task in time delay is 5. Other task state codes are defined in Appendix G. 
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Activate time delay call block : 



(A)1 37482 



E !6 


ERROR CODE 


TASK ID 





The following is an example of coding of a supervisor call block for an Active-Time-Delay Task 
call: 

SCBR BYTE >E00,>1 3 Activate task 1 3 16 , a task in a time delay. 

6.2.6 UNCONDITIONAL WAIT SUPERVISOR CALL 6 16 . Unconditional Wait supervisor call 
6 16 suspends the calling task indefinitely, unless an Activate Suspended Task supervisor call that 
specifies the task has already been executed. In that case, execution resumes immediately. Other- 
wise, the calling task remains suspended until another task executes an Active Suspended Task 
supervisor call for this task. The supervisor call block consists of a single byte that contains the 
code, and need not be aligned on a word boundary. 



Unconditional Wait call block: o 



(A)1 37483 

The following is an example of coding a supervisor call block for an Unconditional Wait call: 



SCBW BYTE >6 



Suspend the calling task unconditionally. 



6.2.7 ACTIVATE SUSPENDED TASK SUPERVISOR CALL 7 16 . Activate Suspended Task 
supervisor call 7 16 activates the specified suspended task. When the specified task has not yet been 
suspended by an Unconditional Wait supervisor call, the effect of this supervisor call is to activate 
the task immediately following execution of an Unconditional Wait supervisor call. The supervisor 
call block consists of three bytes, and need not be aligned on a word boundary. Byte contains the 
code, and the system returns a value in byte 1 . Byte 2 contains the task identifier assigned when the 
task was loaded. 

When the system is unable to locate the task in the system, it returns a -1 in byte 1 of the supervisor 
call block. Otherwise, the system returns the task state code in that byte. The task state code for 
a suspended task is 6 16 . Other task state codes are defined in Appendix G. 



Activate suspended task call block: 



TASK ID 



ERROR CODE 



(A)137484 

The following is an example of coding for a supervisor call block for an Active Suspended Task call: 



SCBSBYTE >7,0,>11 



Activate task 1 1 16 , previously suspended. 



6. END OF TASK SUPERVISOR CALL 4 16 . End of Task supervisor call 4 16 closes all LUNOs 
assigned by the task and terminates the task. The supervisor call block consists of a single byte that 
contains the code, and need not be aligned on a word boundary. 
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End task call block: 



(A)137485 

The following is an example of coding for a supervisor call block for an End-of-Task call: 
SCBE BYTE >4 Terminate calling task normally. 

6.2.9 END OF PROGRAM SUPERVISOR CALL 16 16 . End-of-Program supervisor call 16 16 
terminates a task. The supervisor call block consists of a single byte that contains the code, and 



need nou ue aiigneu on 



u. OOu.iIu.aIv. aIiC luni/iiUH Oi an j-JiU-Uj -a lOtiiain v^aii ia iu LIUbc an 



LUNOs assigned by the task, to terminate the task, and to execute the rebid task which is normally 
the TXDS control program. The rebid task is discussed in Appendix J. 



End program call block: 



16. 



16 



(A)1 37486 

The following is an example of coding for a supervisor call block for an End of Program call: 



SCBPBYTE >16 



Terminate calling task normally. 



6.2.10 GET PARAMETERS SUPERVISOR CALL 17 16 . Get Parameters supervisor call 17 16 
obtains task parameters passed to the task by an EXECUTE OCP command or by a Bid Task 
supervisor call. When a task includes a Get Parameters supervisor call, it must be the first supervisor 
call in the task. The supervisor call block consists of six bytes, aligned on a word boundary'. Byte 
contains the code, and byte 1 contains zero. The system places the parameters in bytes 2 through 5, 
in the same order in which they were placed in the EXECUTE command or in the Bid Task call. 



Get parameters call block: 



(A)1 37487 



!7 16 





BID PARAMETER 1 


BID PARAMETER 2 



The following is an example of a supervisor call block for a Get Parameter call: 

SCBGDATA >1 700,0,0 Obtain task parameters in two words at location SCBG+2. 

6.2.11 GET OWN ID SUPERVISOR CALL 20i 6 . Get Own ID supervisor call 20 16 returns the 
Task ID of the user task in byte 1 of the call block. The call block contains two bytes and need not 
be aligned on a word boundary. Byte contains the code, and byte 2 is the task ID returned by the 
system. 

Get own ID call block: 



20 16 


TASK ID 



(A)1 37488 

The following is an example of coding of the Get-Own-ID supervisor call: 
SCBB BYTE >20,0. 
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6.2.12 MAKE TASK PRIVILEGED SUPERVISOR CALL 23 16 . This supervisor call will make the 
calling task privileged, which allows the task to perform direct disc I/O, and to execute a Get 
System Table supervisor call. The supervisor call block contains two bytes and need not be aligned 
on a word boundary. Byte is the code and byte 1 is unused. 



Make task privileged call block: o 



23 16 


RESERVED 



(A)1 37439 

The following is an example of the Make Task Privileged supervisor call: 
SCBB BYTE >23,0 

6.3 CODE CONVERSION SUPERVISOR CALLS 

The code conversion group of supervisor calls consist of four supervisor calls that convert the binary 
value in a word to ASCII characters, or a group of ASCII characters to a binary value. The super- 
visor calls are described in the following paragraphs. 

6.3.1 CONVERT BINARY TO DECIMAL ASCII SUPERVISOR CALL A 16 . Convert Binary to 
Decimal ASCII supervisor call A 16 converts the binary value in task workspace register to the 
ASCII representation of the equivalent decimal value. The supervisor call block consists of eight 
bytes, and need not be aligned on a word boundary. Byte contains the code and byte 1 contains 
zero. The system places an ASCII minus sign in byte 2 when the value being converted is negative, 
or a blank in that byte when the value is zero or positive. The converted value is placed in bytes 
3 through 7, right-justified with leading blanks. 



Convert bin to decimal ASCII call block: ° 

2 
4 

6 



(A)1 37490 



— — — — — — — — — — — 

A !6 





SIGN 




CONVERTED 




VAI 


JUE 



The following is an example of coding a supervisor call block for a Convert Binary to Decimal 
ASCII call: 



SCBD BYTE 



>A,0,0,0,0,0,0,0 



Convert value in workspace register to decimal 
ASCII and place the result in the supervisor call 
block. 



The following examples show typical values and the results: 

Register Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7 



000 1 16 
7FFF 16 
FFFF 16 



20 16 


20 16 


20 16 


20 16 


20 16 


31 16 


20 16 


33 16 


32 16 


37 16 


36 16 


37 16 


2D 16 


20 16 


20 16 


20 16 


20 16 


31 w 
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6.3.2 CONVERT DECIMAL ASCII TO BINARY SUPERVISOR CALL B 16 . Convert Decimal 
ASCII to Binary supervisor call B 16 converts the ASCII characters in bytes 2 through 7 of the super- 
visor call block to a binary value, and places the value in task workspace register 0. The supervisor 
call block consists of eight bytes and need not be aligned on a word boundary. Byte contains the 
code; and the system returns a value in byte 1. The calling task places the sign of the decimal value 
in byte 2, which may be the ASCII representation of +, -, zero, or blank. A - identifies the value as 
negative, and +, blank, or zero identifies the value as zero or positive. The ASCII representations of 
the decimal digits are entered in bytes 3 through 7, right-justified with leading blanks or ASCII 
zeros. When the system is able to perform the complete conversion correctly, it returns a zero in 
byte 1. When one or more of the characters are not valid, or the decimal number is not within the 
range of -32,768 to 32,767, the system is not able to complete the conversion, and returns a value 



of -1 in byte 1 



Convert decimal ASCII to binary call block: o 

2 
4 

(A)1 37491 6 



B 16 


RETURNED VALUE 


SIGN 


ASCII 


VALUE 



The following example shows the coding of a supervisor call block for a Convert Decimal ASCII 
to Binary call: 

SCBB BYTE>B,0,'0\ ' ', ' 737778' Convert 378 to its binary equivalent and place the 

result in workspace register 0. 

The following examples show typical ASCII values and results. 

Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7 Register Byte 1 



2B 16 


20 16 


20 16 


20 16 


20 16 


31 w 


0001 16 





20 16 


20 16 


20 16 


20 16 


31i« 


41 16 


Undefined 


FF 16 


30„ 


33 ,* 


32 1fi 


37,* 


36 1fi 


37i* 


7FFF 1fi 





2D 16 


30 16 


30 16 


30 16 


30 16 


31i« 


FFFF 16 






6.3.3 CONVERT BINARY TO HEXADECIMAL ASCII SUPERVISOR CALL C 16 . Convert 
Binary to Hexadecimal ASCII supervisor call C 16 , converts the binary value in task workspace 
register to the ASCII representation of the equivalent hexadecimal value. The supervisor call block 
consists of six bytes, and need not be aligned on a word boundary. Byte contains the code, and 
byte 1 contains zero. The system returns the result in bytes 2 through 5. 



Convert binary to hex ASCII call block 



(A)137492 
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The following is an example of coding of a supervisor call block for a Convert Binary to Hexadeci- 
mal ASCII call: 

SCBH BYTE >C,0,0,0,0,0 Convert the value in workspace register to hexadecimal 

and place the result in the supervisor call block. 

The following examples show typical values and the results: 
Register Byte 2 Byte 3 Byte 4 Byte 5 



000 1 16 


30 16 


30 16 


30 16 


31l6 


7FFF 16 


37 16 


46 16 


46 16 


46 16 


FFFF 16 


46 16 


46 16 


46 16 


46 16 



6.3.4 CONVERT HEXADECIMAL ASCII TO BINARY SUPERVISOR CALL D 16 . Convert Hexa- 
decimal ASCII to Binary supervisor call D 16 converts the ASCII characters in bytes 2 through 5 of 
the supervisor call block to a binary value, and places the value in task workspace register 0. The 
supervisor call block consists of six bytes, and need not be aligned on a word boundary. Byte con- 
tains the code, and the system returns a value in byte 1 . The calling task places the ASCII charac- 
ters representing the hexadecimal digits in bytes 2 through 5. When the system is able to perform 
the complete conversion correctly, it returns a zero in byte 1 . When one or more of the characters is 
not valid, the system is not able to complete the conversion, and returns a value of -1 in byte 1. 



i lo uecimai can 


U1UCJK.. 
O 

2 


D 16 




RETURNED VAUJE 








(A) 137493 


4 




ASCII VAUJE 











The following is an example of coding a supervisor call block for a Convert Hexadecimal ASCII to 
Binary call: 

SCBH BYTE >D,0,'0 , ,'3','F','4' Convert 03F4 16 to binary. 

The following examples show typical ASCII values and results: 

Byte 2 Byte 3 Byte 4 Byte 5 Register Byte 1 



30 16 


30 16 


30 16 


31l6 


000 1 16 





30 16 


30 16 


33 16 


4B 16 


Undefined 


FF 16 


37 16 


46 16 


46 16 


46 16 


7FFF 16 






46 16 46 16 46 16 46 16 FFFF 16 

6.4 MEMORY ALLOCATION SUPERVISOR CALLS 

The memory allocation group of supervisor calls consist of five supervisor calls that allow the user 
to access various blocks of memory. These supervisor calls are described in the following paragraphs. 

6.4.1 GET MEMORY SUPERVISOR CALL 12 16 . Get Memory supervisor call 12 16 allocates 
a specified number of contiguous 32-byte blocks to the calling task. Each block is aligned on a 
word boundary. The address of the first byte in the first block is returned in user task workspace 
register 9. The supervisor call block consists of four bytes, aligned on a word boundary. Byte 
contains the code, and the system returns a value in byte 1 . Bytes 2 and 3 contain the number of 
blocks desired. 
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The TX990 Operating System allocates memory in the dynamic task space. If the requested 
memory is not available, TX990 returns a -1 in byte 1 of the supervisor call block. 



12 



16 



ERROR CODE 



NUMBER OF 32-BYTE BLOCKS TO GET 



Get memory call block: 

o 

2 
(A)1 37494 

The following is an example of a supervisor call block for a Get Memory call: 

SCBG DATA >1200,16 Allocate 256 words of memory to the calling task and return 

the address of the memory area in workspace register 9. 

6.4.2 RELEASE MEMORY SUPERVISOR CALL 13 16 . The Release Memory supervisor call 13 16 
returns memory to the available pool in the dynamic task area. The calling task places the address of 
the first byte of the first block of memory that would be released in task workspace register 9. The 
supervisor call block consists of four bytes, aligned on a word boundary. Byte contains the code, 
and byte 1 contains zero. Bytes 2 and 3 contain the number of blocks that would be released. 



Release memory call block: 



o 



13 



1 6 



NUMBER OF BLOCKS TO BE RELEASED 



(A)1 37495 

The following is an example of a supervisor call block for a Release Memory call: 

SCBR DATA > 1300,1 6 Release 256 words of memory starting at the address specified 

in workspace register 9. 

6.4.3 GET SYSTEM TABLE SUPERVISOR CALL 21 16 . Get System Table supervisor call 21 16 
returns to the caller the address of the system table in which pointers to data structures within 
TX990 are located. This call can only be made by a privileged task, The supervisor call block 
contains four bytes, bytes through 3, and must be aligned on a word boundary. Byte contains 

tain the address of the system table. 

The system table has the following format: 

• Word is a pointer to the system time and date block. The time and date blocks consist 
of five words with the following data: 

year, Julian day, hour, minute, and second. 

• Word 1 is a pointer to the first element in the Task-Status-Block (TSB) chain. 

• Word 2 is a pointer to the first element in the Physical-Device-Table (PDT) chain. 

• Word 3 is a pointer to the first element in the Logical-Device-Table (LDT) chain. 

• Word 4 is a pointer to the default disc name. 
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• Word 5 is a pointer to the Device Name Table (DNT). 

• Word 6 is a pointer to the first element in the Procedure Status Block (PSB) chain. 
Get system table call block: 



2! 



16 



RESERVED 



RETURNED ADDRESS 



(A)1 37496 

Coding example: 

SCBB DATA >2 100,0 

with the address of the system table returned in the second word of the call block. 

6.4.4 GET COMMON DATA ADDRESS SUPERVISOR CALL 10 16 . Get Common Data Address 
supervisor call 10 16 causes the system to return the address of the beginning of the COMMON 
area of memory in task workspace register 9, and the size of the area (in bytes) in task workspace 
register 8. The size of the COMMON area is a system parameter specified at system generation. 
The supervisor call block consists of two bytes and need not be aligned on a word boundary. Byte 
contains the code, and the system returns a value in byte 1. 

When no intertask common has been specified for the system, the system returns a -1 in byte 1 of 
the supervisor call block. Otherwise, the system returns in that byte. 

Get COMMON call block: 



10 16 


ERROR CODE 



(A)1 37497 

The following is an example of coding a supervisor call block for a Get Common Data Address 
supervisor call: 



SCBGBYTE >10 J 



Supply address and size of common memory in workspace 
register 9 and 8, respectively. 



6.4.5 RETURN COMMON DATA SUPERVISOR CALL 1B 16 . Return Common Data supervisor 
call 1B 16 performs no operation in TX990 Operating System. The call is included for compatibility 
with DX10 Operating System. The supervisor call block consists of single byte that contains the 
code, and need not be aligned on a word boundary. 



Return COMMON call block : o 



IB 



1 6 



(A)1 37498 

The following is an example of the coding of a supervisor call block for a Return Common Data call: 



SCBRBYTE >1B 



Perform a no-operation. 
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6.5 INTERTASK COMMUNICATION SUPERVISOR CALLS 

The Intertask Communication supervisor calls allow the user to pass messages between tasks. The 
system must include Intertask Communication and buffers for messages specified during system 
generation. 

The Intertask Communication supervisor calls are the Put Data and the Get Data supervisor calls. 
Each call specifies an identifier that corresponds to a queue of data messages. Put Data calls that 
specify a given identifier place the data messages in the queue in the order in which the calls are 
executed. Get Data calls that specify the same identifier retrieve the data messages in the first-in 
first-out sequence. 

Messages are queued in buffers supplied by Buffer Management. The number of buffer pools, the 
sizes of the buffers, and the numbers of buffers in each pool are specified during system generation. 
The number of characters required for a message buffer includes the overhead (eight characters per 
message). When a task executes a Put Data supervisor call to place an 80-character message in a 
buffer, the system requests a buffer at least 88 characters in size. Buffer pools must be specified to 
provide an adequate number of buffers of adequate size to support the Intertask Communication 
supervisor calls in the concurrently executing tasks. 

6.5.1 PUT DATA SUPERVISOR CALL 1C 16 . Put Data supervisor call 1C 16 places a message 
from a specified buffer in the user's task into a queue of data messages. The supervisor call block 
consists of 12 bytes aligned on a word boundary as shown in figure 6-1. Byte contains the code 
and the system places a status code in byte 1 at the completion of the operation. Byte 2 contains 
the Purge flag in the most significant bit. The Purge flag should be set to zero for a Put Data 
supervisor call. Byte 3 contains the identifier, a number less than 255. Bytes 4 and 5 contain the 
address of the buffer that contains the message. Bytes 6 and 7 are not used by the Put Data 
supervisor call. Bytes 8 and 9 contain the number of characters in the message. Bytes 10 and 1 1 
contain zero. 

The operation places the specified number of characters from the specified buffer into the queue 
corresponding to the identifier. The system returns zero in byte 1 when the operation completes 
sucessfully, and -1 (FFi 6 ) in byte 1 when memory is not available in a queue for the message. 



RELATIVE 
ADDRESS 



10 



CODE 



STATUS 



IDENTIFIER 



BUFFER ADDRESS 



MESSAGE LENGTH 



ACTUAL MESSAGE LENGTH 



(A) 137510 



Figure 6-1. Intertask Communication Supervisor Call Block 
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The following is an example of coding for a supervisor call block for a Put Data supervisor call: 



SCBP 



DATA 


>1C00 




BYTE 
BYTE 
DATA 
DATA 
DATA 
DATA 




25 

MSGl 



80 




FLAGS 

IDENTIFIER 

BUFFER ADDRESS 

NOT USED 

80 CHARACTERS 

ZERO REQUIRED 



Place message in buffer at address 
MSGl in queue for identifier 15. 
Message contains 80 characters. 



6.5.2 GET DATA SUPERVISOR CALL 1D 16 . Get Data supervisor call 1D 16 obtains a message 
from a specified queue and places it in the specified buffer in the user's task. The supervisor call 
block consists of 12 bytes aligned on a word boundary as shown in figure 6-1. Byte contains the 
code and the system places a status code in byte 1 at completion of the operation. 

Byte 2 contains the Purge flag in the most significant bit. When the Purge flag is set to 1 , the super- 
visor call deletes all the messages in the specified queue and does not place a message in the 
specified buffer. When the Purge flag is set to 0, the supervisor call performs the normal operation. 
Byte 3 contains the identifier of the queue from which the message is obtained. Bytes 4 and 5 con- 
tain the address of the buffer into which the message is placed. Bytes 6 and 7 contain the maximum 
number of characters to be placed in the buffer. The system places the number of characters 
actually received in bytes 8 and 9 at completion of the operation. Bytes 10 and 11 contain zero. 

When the Purge flag is set to 0, the operation transfers a message from the queue associated with the 
specified identifier to the user's buffer. Messages in the queue are transferred in first-in first-out 
order. The number of characters transferred is the number of characters in the message or the 
number of characters specified in bytes 6 and 7 of the supervisor call block, whichever is less. When 
the Purge flag is set to one, the operation deletes all the messages in the queue associated with the 
specified identifier. The system returns zero as a status code in byte 1 when the operation com- 
pletes successfully. When there is no message in the specified queue, the system returns -1 (FF 16 ) in 
byte 1 . The following is an example of coding for a supervisor call block for a Get Data supervisor 
call: 



SCBG DATA >1D00 GET DATA 

BYTE NORMAL OPERATION 

BYTE 35 IDENTIFIER 

DATA RMSG BUFFER ADDRESS 

DATA 64 64 CHARACTERS 

DATA ACTUAL MESSAGE LENGTH 

DATA ZERO REQUIRED 



Obtain a message up to 64 charac- 
ters in length (or the first 64 char- 
acters of a longer message) from the 
queue for identifier 35 and place 
the message in a buffer at location 
RMSG. 



6.6 DATE AND TIME SUPERVISOR CALL 3 16 

Date and Time supervisor call 3 16 returns date and time in binary form. The supervisor call block 
consists of four bytes, aligned on a word boundary. Byte contains the code, and byte 1 contains 
zero. Bytes 2 and 3 contain the addresses of a five-word area into which the function places the 
result. The binary values corresponding to the year, day, hour, minute, and second are placed in 
the first through fifth words of that area, respectively. 
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Date and time call block: 

(A)1 37499 

Buffer block: 



(A)1 37500 



BUFFER ADDRESS 



YEAR 



DAY 



HOUR 



M I NU TE 



SECOND 



The following is an example of coding for a supervisor call block for a Date and Time call: 

SCBT DATA >300,DAT Place date and time data in a five-word area at location 

DAT. 



6-13/6-14 



Digital Systems Division 




946259-9701 



SECTION VII 
DEVICE AND FILE I/O SUPERVISOR CALLS 



7.1 INTRODUCTION 

The TX990 Operating System provides several supervisor calls used for performing I/O to devices 
and files. Supervisor call 00 may be used to perform many general I/O and file management 
operations which apply to many different types of devices and files. Three supervisor calls to 
perform character mode I/O to Video Display Terminals are provided. Also provided are a Wait for 
I/O SVC and two Abort I/O SVCs. Table 7-1 lists the I/O supervisor calls. The following paragraphs 
describe each SVC separately. 

Table 7-1. I/O Supervisor Calls 

Hexadecimal 
SVC Name SVC Code 

General I/O 00 

TX990 release 1 .0 file management 1 5 

VDT utility 1A 

VDT character input 8 

VDT conditional character input 18 

Wait for I/O 1 

Abort I/O by LUNO F 

Abort I/O by call block IE 

7.2 I/O SUPERVISOR CALL (00) 

The general I/O supervisor call (SVC 00) is used to perform I/O to devices and files, and to perform 
many file manipulation operations. The SVC is programmed by coding the appropriate bytes in the 
call block, as shown in figure 7-1 . 

The coding of the bytes is described below. 

• Byte Coded by user with 00 16 (for supervisor call 00 16 ). 

• Byte 1 Error status code returned by TX990. For the list of error status codes, see 

Appendix I - I/O Error Codes. 

• Byte 2 Coded by user with the I/O operations code (described in paragraph 7.2.1). 

• Byte 3 Coded by user with the LUNO number to be associated with the I/O device or 

file to be utilized for the I/O operation. The LUNO is ignored during Create 
File, Delete File, Compress File, Unprotect File, Write Protect File, and Delete 
Protect File Operations. 
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, 1 



2,3 



6 ,7 



8 ,9 



10,11 



12,13 



14,15 



16,17 



18,19 



20 ,21 



22 ,23 



24 , 25 



26 ,27 



28 ,29 



30 ,31 



32 ,33 



34 ,35 



oo 16 



ERROR STATUS CODE 



NT 2 



'Y 2 



AP 

_L 



c 2 



DATA BUFFER ADDRESS 



READ CHARACTER COUNT 



WRITE CHARACTER COUNT 



REPLY BUFFER ADDRESS OR 
LOGICAL RELATIVE RECORD NUMBER 



1 } 



LOGICAL RELATIVE RECORD NUMBE 



4 r u 



DRD NUMBER __ ^ 



DATA 
TYPE 



FILE 
TYPE 

J L 



LOGICAL RELATIVE RECORD SIZE 



NOT USED 



PATHNAME POINTER 



NOT USED 



NOT USED 



NOT USED 



NOT USED 



NOT USED 



NOT USED 



REQUIRED 

FOR SEQUENTIAL 

RECORD I/O 

DEVICE-FILE 

OPERATIONS 



REQUIRED 
FOR RELATIVE 

RECORD I/O 
DEVICE-FILE 
OPERATIONS 



REQUIRED 

FOR 
OP CODES 
90, 6 -99 16 



ONLY 

NECESSARY 

FOR DX10 

COMPATIBILITY 



NOTE 1 : SYSTEM FLAGS 



BSY = BUSY FLAG 

ERR = ERROR FLAG 

EOF = END-OF-F1LE FLAG 

I = IGNORED 



(B)1 35908B 



NOTE Z: USER FLAGS 



INT = INTIATE FLAGS 
RPY = REPLY FLAG 



AP = ACCESS PRIVILEGE 
FLAG 



LOCK AND UNLOCK 
FLAG 



C = COMMUNICATION TIME- 

OUT FLAG 



NOTE 3 1 UTILITY FLAGS 



Figure 7-1. Supervisor Call Block for I/O Supervisor Call 00i 6 



AC = AUTO— CREATE FLAG 

I = IGNORED 

AT = ALLOCATION TYPE 
(CONTIGUOUS/ 
NONCONTIGUOUS) 
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NOTE 

Bytes 4 through 15 are ignored by I/O operation codes 90 i6 
through 99 16 . 

• Byte 4, bit TX990 places a 1 in the busy bit during an I/O operation. When the task 

codes the Initiate I/O flag to 1 , it must monitor this bit when waiting for 
the I/O to complete. 

• Byte 4, bit 1 TX990 places a 1 in the error bit when the I/O operation terminates in 

error. It is for normal termination. 

• Byte 4, bit 2 The operating system sets this bit to 1 when it detects an end-of-file 

record ; otherwise, it is set to 0. 

• Byte 4, Unused, 
bit 3-7 

• Byte 5, bit Coded by the user with the initiate I/O flag. When this bit is set to 1, 

the operating system will begin the specified I/O operation and return 
control to the task before the I/O is completed. When this bit is set to 0, 
the operating system will not return control to the task until the I/O 
operation is completed. This bit is useful when buffering I/O. 

• Byte 5, bit 1 Coded by the user with the reply flag. This bit should only be set to 1 

when the I/O operation is a write and the LUNO specifies an interactive 
device. When the bit is set to I, the specified write will be followed by a 
read, allowing the task to receive a reply from the interactive device. When 
this bit is 1, byte 12-13 must contain the address of a reply block. A reply 
block is a 3-word block: the first word is coded by the user and must con- 
tain the buffer address that contains the characters entered in reply to the 
write operation; the second word must contain the maximum number of 
characters expected to be entered (usually the size of the reply buffer); 
the third word will be returned by the operating system and will contain 
the number of characters actually entered in reply to the write operation. 

• Byte 5 , bit 2 Ignored by TX990 . 

• Byte 5, Coded by the user to attain the access privilege, during an open opera- 
bit 3-4 tion. These bits are ignored during another operation. 

00 — Exclusive all flag indicating that only one task may open the file 
concurrently. 

10 - Shared flag indicates more than one task may open the file con- 
currently. This bit should only be set when doing an open operation 

to a relative record file. 
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Byte 5, bit 5 Coded by the user to lock or unlock a logical relative record. When set, 
this flag specifies that the logical relative record is to be locked for all 
read operations and unlocked for all rewrite operations. A locked record 
cannot be read or rewritten by any task except the locking task, and then 
the locking task must use the same LUNO. Any task can unlock a record 
using a 4A 16 I/O operation. When this flag is zero, then current status 
(locked or unlocked) is unchanged. 

Byte 5, bit 6 Coded by the user with the communications timeout flag. See the Com- 
munications manual for more detail. 



• 



Byte 5, bit 7 Not used by TX990. 



• Bytes 6-7 The user must code these bytes to contain the starting address of the I/O 

buffer. 

• Bytes 8-9 The user must code these bytes when using a read I/O operation code. 

The bytes must contain the maximum number of characters to be read. 
When the record length specified exceeds the maximum number of charac- 
ters that the device-file supports, only the number of characters that are 
supported by the device-file applies. Not used for write operations. 

• Bytes 10-11 When a Write I/O operation is used, bytes 10-11 will contain the number 

of characters to be written. When the character count exceeds the maxi- 
mum number of characters for the device-file, the maximum number of 
characters for the device-file applies. When a Read I/O operation is used, 
the operating system will return the actual number of characters read in 
these bytes. 

• Bytes 12-13 When the user sets the reply flag to 1, these bytes must contain the 

address of the reply block described above. These bytes need not be 
appended to the above bytes if the I/O operations are directed to sequen- 
tial device-files. 

• Bytes 12-15 When the user is doing I/O operations to relative record files, these bytes 

contain the logical record number. The operating system will update 
these bytes after I/O operations. These bytes need not be appended to 
the above bytes, except when directing I/O to a relative record file. 

• Bytes 16-34 Need not be appended to the above bytes except when using I/O opera- 

tion codes 90 16 through 99 16 . 

• Bytes 16-17 Utility Flags. 

• Bytes 16-17, Need to be zero for DX10 compatibility. TX990 ignores it. 
bit 0-2, 4-5, 7, 9-10 

• Bytes 16-17, Need to be one for DX10 compatibility. TX990 ignores it. 
bit 3, 8 
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• Bytes 16-17, User sets to one to request automatic logical file creation. It is set during 
bit 6 an assign I/O device-file operation and causes a file to be created during an 

Open I/O operation. 

• Bytes 16-17, The user must code these bits in the following manner: 
bit 11-12 



• 



Code 


Meaning 


00 


Binary data 


01 


ASCII data 



10,1 1 Reserved for new data formats 

These bits are ignored except during create file operations. 

• Bytes 16-17, Set to one when creating a noncontiguous file or to a zero when creating 
bit 13 a contiguous file. TX990 will ignore the bit if it is set to zero and will 

create a noncontiguous file without flagging an error. TX990 supports 
only non-contiguous files. This bit is ignored except during create file 
operations. 

• Bytes 16-17, Set to one of the following codes to specify the file type when the file is 
bit 14-15 created. This field is ignored except for create operations. 

Code Meaning 

00 undefined 

01 sequential file 

10 relative record file 
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Bytes 18-19 When using create file operations to create a relative record file, the user 
must code these bytes with the number of characters in each record 
(i.e., record size). These bytes are ignored when creating a sequential file. 

Bytes 20-2 1 These bytes are not used by TX990. 

Bytes 22-23 The user must code these two bytes with address of a pathname. These 
bytes are used for Assign LUNO, Create File, Delete File, Change the 
Name, Unprotect File, Write Protect File, Delete Protect I/O operations. 
All other operations ignore this field. The pathname is in the following 
format : 

Count Pathname 

Byte n Byte 1 -n 

The first byte at the pathname address is the character count. The follow- 
ing bytes are the pathname itself. 

Byte 24-35 Need only be appended for DX 10 compatibility. 
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7.2.1. I/O OPERATIONS. The I/O SVC may be used to perform all of the operations listed in 
Table 7-2, by coding the correct I/O opcode in byte 2 of the call block, and correctly defining the 
remaining fields in the call block. The opcode for each operation is given in the table. 



Table 7-2. SVC 00 I/O Operations 



Operation 

Open 

Close 

Close with end-of-file 

Open with rewind 

Close and unload 

Read device status 

Forward space 

Backward space 

Read ASCII 

Read direct 

Write ASCII 

Write direct 

Write end-of-file 

Rewind 

Unload 

Create file 

Assign LUNO to pathname 

Delete file 

Release LUNO assignment 

Compress file 

Assign new file name 

Un protect file 

Write protect file 

Delete protect file 

Verify pathname 

Unlock 



Hexadecimal 
Opcode 

00 

01 

02 

03 

04 

05 

06 

07 

09 

0A 

0B 

0C 

0D 

0E 

OF 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 

4A 



NOTE 

Most of the "ninety" opcodes do not apply to device operations 
(exceptions are Assign and Release LUNO). Table 7-3 shows which 
of the other operations apply to which devices. 

The following paragraphs describe each operation in detail. 

7.2.2 OPEN OPERATION (CODE 00 16 ). The Open operation is specified by placing code 00 16 in 
byte 2 of supervisor call block. A description of how the Open operation controls the I/O device 
and the file on the medium of the I/O device is presented in the following subparagraphs. 
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7.2.2.1 Controlling the I/O Device. When a device is designated during system generation to be in 
the file mode (i.e., available to be utilized by only one program), the open operation causes the 
device to be assigned solely to the calling program until a close operation (i.e., Close, Close with 
EOF, or Close Unload is executed. In addition, when a device is designated during system genera- 
tion to be in the file mode, an open operation (i.e., Open or Open Rewind) must be performed be- 
fore any other file management operation is executed. Until an open operation is executed, files on 
diskettes are not located and file management operations to manipulate them cannot be initiated or 
performed. 

The following device operation(s) result from execution of an open operation: 

• Dummy No operation. 

• 91 1 or 913 VDT Performs a line feed and a carriage return. 

• 733 ASR Keyboard/ Performs a line feed and a carriage return. 
Printer 

• 33 ASR Teletype Performs a line feed and a carriage return. 
Keyboard /Printer 

• 33 ASR Teletype Two bells are output and a RUB OUT key must be entered. 
Paper Tape Punch, 

and Reader 

• Other devices No operation. 

When a device responds to an open operation, the operating system returns the device code 
number (table 7-3) to bytes 6 and 7 of the supervisor call block, which bytes are usually used for 
data buffer address field. 

7.2.2.2 Controlling the Diskette File. When a relative record file is to be exclusively accessed, the 
shared access flag in byte 5 of the supervisor call block, for the open operation, must be set to zero. 
Sequential files are always exclusively accessed. The file then remains assigned to the program until 
the program is terminated or until a close operation is executed. In response to an open operation 
to a file, the operating system returns the file code number (table 7-4) to bytes 6 and 7 of the 
supervisor call block (which bytes are usually used for the data buffer address), code 01FF 16 to 
indicate that a sequential file has been opened or code 02FF 16 to indicate that a relative record file 
has been opened. When the auto create flag is set during the assign LUNO to pathname operation, 
the open operation causes a file to be created if the file does not already exist. When a relative 
record file is opened, the record size is returned in bytes 8-9 of the call block. 

7.2.3 CLOSE OPERATION (CODE 01 16 ). The close operation is specified by placing code 01 16 in 
byte 2 of File Management Supervisor Call Block 00 16 . When specified by the user, the close opera- 
tion releases the I/O device and the file on the medium of the I/O device from the calling task. 
When a task assigns more than one LUNO to an I/O device and opens them, a close operation 
should be executed for all LUNOs for which an open operation was performed. When a close 
operation is executed to a diskette file, the file is released from the task and any records locked 
by the task are released. When I/O device is designated to be in the file mode during system 
generation, a close operation (or close with EOF or close unload) must be executed to release 
the file from the calling task. 
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D 

<Q 
S* 
C/5 
Co 
CD 

3 

CO 

D 
<" 
co" 

6' 



I/O Code/Operation 
(Hexadecimal) 



00 16 
OPEN 

01 16 

CLOSE 

02 16 
CLOSE-WRITE EOF 

03 16 
OPEN-REWIND 

04 16 
CLOSE-UNLOAD 

05 16 

READ DEVICE STATUS 

06 16 

FORWARD SPACE 

07 16 

BACKWARD SPACE 

09 16 

READ ASCII 

0A 16 

READ DIRECT 

0B 16 

WRITE ASCII 

oc 16 

WRITE DIRECT 



Table 7-3.1/0 Operations (Record Mode) 




733ASR/KSR Card Line 733 ASR 

or 743 KSR Reader Printer Cassette Units 

Keyboard/Printer 

R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 
R 
R 
R 
R 
I 



R 



R 



R 



R 



R 



R 



R 



R 
R 
R 
R 
R 
R 



913/911 Dummy 33 ASR 33 ASR 33 ASR 

VDT Device Keyboard/Printer Punch Reade*- 



(Record Mode) 
R 

R 

R 

R 

R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 



R 


R 


E 


R 


I 


E 


E 


R 


I 


R 


R 


E 



I/O Code/Operation 
(Hexadecimal) 



0D 16 
WRITE EOF 

0E 16 
REWIND 

0F 16 
UNLOAD 



Table 7-3. I/O Operations (Record Mode)(Continued) 

733ASR/KSR Card Line 733 ASR 913/911 Dummy 33 ASR 33 ASR 33 ASR 

or 743 KSR Reader Printer Cassette Units VDT Device Keyboard/Printer Punch Reader 

Keyboard/Printer (Record Mode) 




R 



R 



R 



R 



R 



R 



R 



I 



R 



R 



E 



-£» 

& 
to 

■ 

-J 

o 



4A )6 
UNLOCK 

Note: Unlock I/O operation used for relative record diskette files. 



R Response 
1 Ignored 
E Error 
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Table 7-4. Device Code Numbers and File Code Numbers 

Device/File Name Device Code Number File Code Number 

Dummy 0000 

743 KSR or 733 ASR/KSR Keyboard /Printer 0001 

Line Printer 0002 

733 ASR Cassette Unit 0003 

Card Reader 0004 

9 1 1 or 9 1 3 Video Display Terminal 0005 

33 ASR Keyboard/Printer 0001 

33 ASR Paper Tape Punch 0003 

33 ASR Paper Tape Reader 0003 

Diskette 0006 

Communication Device 0007 

Sequential Record File 01 FF 16 

Relative Record File 02FF 16 



No physical device operation(s) results from execution of a close operation. 

7.2.4 CLOSE WITH EOF OPERATION (CODE 02 16 ). The close with EOF operation is specified 
by I/O operation code 02 16 . The operation consists of the close operation previously described 
and a write EOF operation for the specified device. When the device specified is the keyboard/ 
printer, the printer performs three line-feed operations. When the device specified is the line printer, 
the printer performs a form-feed operation. When the device specified is the 911 or 913 VDT, only 
the close operation is performed. The close with EOF operation is an illegal operation for the card 
reader and the system returns the appropriate error status code. When the device specified is the 
paper-tape punch, an ASCII EOF is punched (DC3, CR, LF, DC3, null, null, null, null) and 80 null 
frames are punched for trailer. If a close with EOF operation is executed to a diskette file, the cur- 
rent position of the file is stored as the end-of-file. The close with EOF operation for relative record 
writes the end-of-file to the record number in bytes 1 2 through 1 5 of the SCB. 

7.2.5 OPEN REWIND OPERATION (CODE 03 16 ). The open rewind operation is specified by I/O 
operation code 03 J6 . The operation consists of an open operation previously described, and a 
rewind operation. When the device is the line printer, the device performs a formfeed operation. 
When the device is a VDT, the system blanks the screen and positions the cursor on column of 
the last row, the home position. When the device is a cassette unit, the device rewinds the cassette 
and places it in the ready state. When the device is the keyboard/printer or the card reader, only 
the open operation is performed. 

When the paper-tape punch is opened with rewind, two bells are output and the user then turns 
on the punch and presses the RUB OUT key. When the RUB OUT key has been pressed then 80 
null frames are punched for leader. For a sequential diskette file, the current record is the first 
record in the file, and for a relative record file, the record number in the SCB is set to zero. 

7.2.6 CLOSE UNLOAD OPERATION (CODE 04 16 ). The close unload operation is specified by 
I/O operation code 04 I6 . This operation consists of a close operation previously described, and an 
unload operation. When the device is the line printer, the device performs a form-feed operation. 
When the device is a cassette unit, the device rewinds the cassette to the clear area at the beginning 
of the tape. When the device is a keyboard/printer or the card reader, only the close operation 
is performed. 
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When the device is the 33 ASR paper-tape punch, 80 null frames are punched. A close unload 
operation to a diskette file causes the file to be closed. 

7.2.7 READ DEVICE FILE STATUS OPERATION (CODE 05 1 6 ). The read device-file status 
operation is specified by I/O operation code 05 16 . The operation is ignored by all devices except 
33 ASR and diskette files. 

When the device is the 33 ASR, the read character count (bytes 8 and 9) is cleared. 

When the device-file is a diskette file, file characteristics and format are stored in the user's buffer 
address, which is specified by bytes 6, 7 of the supervisor call block. The buffer must contain 3 
words. The operating system will return a in word 1. Word 2 will contain the logical record 
length when file is a relative record file; otherwise it will contain a zero. Word 3 will contain the 
physical record length and will be 1 28. 

7.2.8 FORWARD SPACE OPERATION (CODE 06 16 ). The forward space operation is specified 
by I/O operation code 06 16 . The operation is ignored by all devices except the 733 ASR cassette 
units. The operation moves the cassette tape forward a specified number of records or until an 
end-of-file record is read. The number of records to be read is placed in bytes 10 and 11 of the 
supervisor call block. When an end-of-file record is read, the tape is positioned at the beginning 
of the record following the end-of-file. The end-of-file record consists of a DC3 (X-OFF) in the 
first character position of the record. 

The forward space operation causes a diskette file to skip records in the forward direction. Bytes 

10 and 11 of the Supervisor Call Block (SCB) contain the number of records to be skipped. For a 
relative record file, file management updates the record number in the SCB. If an end-of-file occurs 
before the specified number of records has been skipped, the end-of-file flag in the SCB is set, 
and the operation stops. The next operation accesses the first record following the end-of-file. 
Following the operation, bytes 10 and 11 of the supervisor call block contain the number of records 
remaining to be skipped; zero when an end-of-file did not occur. 

7.2.9 BACKWARD SPACE OPERATION (CODE 07 16 ). The backward space operation is spec- 
ified by I/O operation code 07 16 . The operation is ignored by all devices except the 733 ASR 
cassette units. The operation moves the cassette tape a specified number of records in the reverse 
direction. Bytes 10 and 1 1 of the Supervisor Call Block (SCB) contain the number of records to 
be moved. The backward space operation causes a diskette file to skip records in the reverse direc- 
tion. The number of records to be skipped is placed in bytes 10 and 1 1 of the SCB. For a relative 
record file, file management updates the record number in the SCB. For a sequential file, if an 
end-of-file occurs before the specified number of records has been skipped, the operation stops. 
The next operation accesses the first record after the EOF. Following the operation, bytes 10 and 

11 of the SCB contain the number of records remaining to be skipped; zero when an end-of-file 
did not occur. 

7.2.10 READ ASCII OPERATION (CODE 09 16 ). The read ASCII operation, code 09 16 , reads a 
record of the specified file and stores the data, packed two characters per word in the buffer at 
the address in bytes 6 and 7 of the Supervisor Call Block (SCB). The maximum number of char- 
acters in the buffer is placed in bytes 8 and 9 of the SCB. The actual number of characters stored is 
placed in bytes 10 and 11 of the SCB. This number will be the number of characters in the record 
or the value in bytes 8 and 9, whichever is less. If an end-of-file occurs, file management sets the 
EOF bit in the SCB and sets the character count in bytes 10 and 11 of the SCB to zero. When the 
file is a relative record file and no end-of-file was encountered and the read operation is successful, 
file management increments the record number in bytes 12 through 15 of the SCB. 
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NOTE 

The ASCII characters listed for each device in Appendix B are the 
valid characters for that device, and are stored with the most signif- 
icant bit set to zero. Except as noted for the card reader, other 
characters are ignored. 

When the device specified is either the keyboard /printer or the VDT, the operation sounds a tone to 
request the user to enter the characters at the keyboard. Characters are transferred to a buffer until 
the user enters a carriage return (New Line on a 913 VDT) or the number of characters specified in 
bytes 8-9 are entered. A carriage return is not included in the character count. If only a carriage 
return is entered, a zero is returned in the character count word in the SCB. When the device is the 
keyboard /printer, the user may correct the most recently-entered character by entering a backspace 
(CTRL/H). The character is deleted, and the printer performs a backspace and a line feed operation. 
When the device is a VDT, the most-recently entered character may be corrected by entering the 
left arrow (<-), which deletes the character in the buffer and backspaces the cursor. 

When the device specified is a 733 ASR cassette unit, the operation transfers characters from the 
cassette to the specified buffer until an end-of-record is detected or the number of characters 
specified in bytes 8-9 are read. The maximum number of characters in a cassette record is 83. 
When the number of characters to be read is less than the number of characters in the record, 
the remaining characters in the record are not available. An end-of-file record on the cassette 
is a record having a DC3 (X-OFF) character as the first character. The cassette unit does not pro- 
vide a logical end-of-medium indication, but does provide a physical end-of-tape indication. The 
physical end-of-tape indication may indicate either end of the tape. 

When the device specified is a card reader, the operation reads a card and transfers the characters 
read to the specified buffer. The number of characters specified is transferred up to a maximum of 
80 characters. When the number of characters specified is greater than 80, only 80 characters are 
read and transferred. When fewer than 80 characters are specified, the remaining characters on 
the card are not available. Characters other than those listed in Appendix B for the card reader are 
placed in the buffer as spaces, and the system returns an error status code when these characters 
are read. The end-of-file record for the card reader has a slash in the first column and an asterisk 
in the second column (/*). 

The read ASCII operation is an illegal operation for the line printer, and the system returns an 
error status code. 

When the device specified is a 33 ASR paper-tape reader, the operation transfers characters from the 
paper tape to the specified buffer until an end-of-record is detected or the number of characters 
specified in bytes 8-9 are read. An end-of-file record on a paper tape is a DC3 (X-OFF, 13 16 ) 
character as the first character of the input record. The read ASCII operation for the 33 ASR 
paper-tape punch is an illegal operation and the system returns an error code. 

7.2.1 1 READ DIRECT OPERATION (CODE 0A 16 ). The read direct operation is specified by I/O 
operation code 0A 16 . The operation reads the number of characters specified as the record length 
in bytes 8 and 9 of the Supervisor Call Block (SCB). The operation transfers the characters to the 
buffer at the address in bytes 6 and 7 of the SCB without any characters translation and places the 
number of characters read in bytes 10 and 1 1 of the SCB. 

When the device specified is the cassette unit, the system sets the most significant bit of each 
character to zero and stores the characters two per word. The read operation terminates when a 
complete physical record has been read. 
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When the device specified is the card reader, a column on the card is stored in a word of the buffer. 
The four most significant bits of the word are set to zero; the holes in the card are stored as ones, in 
the order shown in figure 7-2. The entire record is transferred to the buffer, and the end-of-file 
record is underfined for a read direct operation. 

When the device specified is the 33 ASR paper-tape reader, each frame contains one byte of 
information in ASCII format. 

A diskette file read direct operation is identical to the read ASCII operation for a diskette file. 

w nen a reao Qirect operation is ati.emj-'ievj. on m6 otner Qevi^v^o, i.ne o^^em returns an x^rror status 
code. 

7.2.12 WRITE ASCII OPERATION (CODE 0B 16 ). The write direct operation, code 0B 16 , 
transfers the data in the buffer at the address in bytes 6 and 7 of the Supervisor Call Block (SCB) to 
the specified file. The characters in the buffer are packed two per word. Bytes 10 and 1 1 of the SCB 
contain the number of characters to be written. When the file is a relative record file and the write 
operation is successful, file management increments the record number in bytes 12 through 15 of 
the SCB. A write ASCII operation clears any end-of-file indication for the current record or for a 
subsequent record. 

NOTE 

Each device recognizes the characters listed for the device in 
Appendix B. Other characters are ignored. 
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Figure 7-2. Bit Manipulation for Direct Read of Card 
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When the device specified is the keyboard/printer, the characters are printed. An HT character 
results in a space, and an FF character results in eight line feed operations. When the device 
specified is the line printer, the characters are also printed. Model 306 and Model 588 Line Printers 
recognize the SO(0E 16 ) character as specifying a line of elongated characters. The SO character 
should be the first character of the line, and causes the printer to print double-width characters on 
the entire line. The number of characters per line is one-half the normal number of characters; i.e., 
40 characters per 80-character line, or 66 characters per 132-character line. 

When the device specified is a cassette unit, the characters are written on the cassette. A carriage 
return in the buffer is translated to an ETB (17 16 ) character. The maximum number of characters 
to be written is 83. When the buffer has been written, the system then writes a carriage return, a 
line feed, a DC4 (record off) character, and a DEL (rub out) character to indicate an end of 
physical record. When the reply bit is set, the response is read from the other cassette unit. 

When a write ASCII operation is attempted on the card reader, the system returns an error status 
word. 

When the device specified is the 33 ASR paper-tape punch, characters are written a byte at a time 
in the ASCII format. A carriage return in the buffer is translated to an ETB (17 16 ) character. The 
system punches an ASCII end-of-record (CR. LF, DC3, null, null, null, null) when the buffer is 
exhausted. When a write ASCII operation is attempted on the 33 ASR paper-tape reader, the system 
returns an error status word. 

7.2.13 WRITE DIRECT OPERATION (CODE 0C 16 ). The write direct operation is specified by 
the I/O operation code 0C 16 . The operation writes a record without performing any translation, 
writing the characters from the buffer at the address in bytes 6 and 7 of the Supervisor Call Block 
(SCB). The number of characters to be written is specified in bytes 10 and 1 1 of the SCB. 

When the device specified is the cassette unit, the seven least significant bits of each byte are written 
on the cassette. The maximum number of characters per record is 83. If a DC4 character is 
embedded in the buffer, the system writes the character and also a DC2 (record on) to continue 
the operation. To assure that the last record is actually written on the tape, the user task should 
place a carriage return in the buffer. When the reply bit is set, the response is read on the other 
cassette unit. 

When the device specified is the 33 ASR paper-tape punch, all eight bits of each byte are punched 
on the paper tape. If a DC4 (14 16 ) character is embedded in the buffer, the system punches the 
character and also a DC2 (record on, 1 2 16 ) to continue the operation. The system punches an 
end-of-record (DC3, null, null, null) when the buffer is exhausted. 

When the device specified is a line printer, the seven least significant bits are sent to the printer and 
the installed options will determine how the characters are interpreted. 

A diskette file write direct operation is identical to the write ASCII operation for a file. 

When the write direct operation is attempted on any other device, the system returns an error 
status code. 

7.2.14 WRITE EOF OPERATION (CODE 0Di 6 ). The write EOF operation is specified by I/O 
operation code 0D 16 . The operation consists of writing the end-of-file record defined for the 
specified device. 
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When the device specified is the cassette unit, the operation writes a DCS (X-OFF) character on 
the cassette. When the device is the keyboard/printer, the operation performs three line-feed 
operations. When the device is the line printer, the operation performs a form-feed operation. When 
the device is the VDT, the operation is ignored. When the device is the card reader, the system 
returns an error status code, and no operation is performed. 

When the device specified is a 33 ASR paper-tape punch, an ASCII end-of-file is punched. 

When the unit specified is a diskette file, the write EOF operation writes the end-of-file record. 
There is no limit to the number of end-of-file records that may be written to a sequential file but 
there may be only one for relative record files. For a relative record file the end-of-file is written in 
the record specified (bytes 12-15 of the supervisor call block). 

7.2.15 REWIND OPERATION (CODE 0E 16 ). The rewind operation is specified by I/O operation 
code 0E 16 . When the device specified is the cassette unit, the operation rewinds the cassette tape to 
the clear area at the beginning of the tape, and then moves the tape in the forward direction to the 
beginning of tape marker, illuminating the READY indicator on the 733 ASR. When the specified 
device is the line printer, the operation performs a form feed operation. 

A diskette file rewind operation simulates the rewinding of a cassette file, causing the next read 
or write operation performed on the file to access the first record in the file (not a subfile). After ' 
a sequential file has been opened and records written to it, the file cannot be rewound until an 
EOF mark is written or the file is closed. When the file is a relative record file, file management 
places a zero in bytes 1 2-1 5 (logical relative record number) of the supervisor call block. 

The rewind operation is ignored by other devices. 

7.2.16 UNLOAD OPERATION (CODE 0F 16 ). The unload operation is specified by operation 
code 0F 16 . The operation is ignored by all devices and files except the cassette unit. The unload 
operation for the cassette unit consists of rewinding the cassette tape to the clear area at the 
beginning of the tape. 

7.2.17 UNLOCK OPERATION (CODE 4A 16 ). The unlock operation, code 4A 16 , unlocks a 
relative record file record that has been locked by a previous read. The record to be unlocked is 
specified in bytes 12 through 15 of the supervisor call block. 

7.2.18 CREATE FILE OPERATION (CODE 90 16 ). The create file operation is specified by 
placing code 90 16 in byte 2 of file management supervisor call 00 16 . To create a file, code utility 
flag byte 16, logical relative record size bytes 18 and 19, and pathname pointer byte 22. All other 
bytes in the supervisor call block, except bytes and 2 are ignored. 

7.2.19 ASSIGN LUNO TO PATHNAME OPERATION (CODE 91 16 ). The assign LUNO to 
pathname operation is specified by placing code 91 16 in byte 2 of the Supervisor Call Block (SCB). 
The user must code byte 3 of the SCB with the LUNO, and byte 22-23 with the pathname pointer 
to the file or device. When the user sets the auto-create bit 6 of bytes 16-17 to a 1, the user must 
also code bits 11-15 of bytes 16-17 and bytes 18, 19 of the SCB. If the diskette file does not al- 
ready exist it will be created when an open operation is executed using the LUNO in byte 3. 
Diskette files are not located by file management until they are opened, therefore the user may 
assign LUNOs to diskette files before the diskette which contains the file is actually loaded. Unlike 
diskette files, devices are located when the LUNO is assigned. All other bytes of the SCB are 
ignored. 



7-1 5 

Digital Systems Division 




946259-9701 



7.2.20 DELETE FILE OPERATION (CODE 92 16 ). The delete file operation is specified by 
placing code 92 16 in byte 2 of the Supervisor Call Block (SCB). The file identified by the pathname 
specified in bytes 22 and 23 is deleted when this operation is executed. Coding of all of the other 
bytes is ignored. When the file to be deleted does not exist, an error is returned. 

7.2.21 RELEASE LUNO ASSIGNMENT OPERATION (CODE 93 16 ). The release LUNO assign- 
ment operation is specified by placing code 93 16 in byte 2 of the Supervisor Call Block (SCB). The 
user must code byte 3 with the LUNO number which is to be released from its previously assigned 
pathname. All other bytes are ignored. 

7.2.22 COMPRESS FILE OPERATION (CODE 94 16 ). The compress file operation is specified 
by placing 94 16 in byte 2 of the Supervisor Call Block (SCB). The user must also code bytes 22-23 
of the SCB with the pathname pointer to the file that is to be compressed. It is beneficial to com- 
press files that have contained a large number of records and then rewritten so they contain fewer 
records than the original file. The compress operation will return the unused allocation units be- 
yond the end-of-file which are not being used by the current file. 

7.2.23 CHANGE FILE NAME (CODE 95 16 ). The user must code bytes 22 and 23 with the 
pointer to the new pathname and code byte 3 with the LUNO which must be previously assigned 
to the old file pathname which is to be changed. Coding of all other bytes is ignored. 

7.2.24 UNPROTECT FILE OPERATION (CODE 96 16 ). The user must code bytes 22-23 with 
the pathname pointer to the file that is to be unprotected. If the file is already opened using an 
open I/O device-file operation, the file will not be unprotected until the file is closed. All other 
bytes are ignored. 

7.2.25 WRITE PROTECT FILE OPERATION (CODE 97 16 ). The user must codes bytes 22-23 of 
the supervisor call block with the pathname pointer to the file that is to be write protected. If the 
file is already opened, the file will not be write protected until the file is closed. All other bytes are 
ignored. 

7.2.26 DELETE PROTECT FILE OPERATION (CODE 98 16 ). The user must codes bytes 22-23 
of the supervisor call block with the pathname pointer to the file that is to be delete protected. 
If the file is already opened, the file will not be deleted protected until the file is closed. Delete 
protected files are also write protected. All other bytes are ignored. 

7.2.27 VERIFY PATHNAME SYNTAX (CODE 99 16 ). The user must code bytes 22-23 of the 
supervisor call block with the pathname pointer to the pathname that is to be verified. If the syntax 
is correct, the error status byte will be 0, otherwise it will contain an error code. See error code, 
Appendix I. 

7.2.28 CODING EXAMPLES USING FILE MANAGEMENT SUPERVISOR CALL 00 16 The 

following is a coding example for a supervisor call block that will write a record to LUNO 8. LUNO 
8 must have been previously assigned to an interactive device. The reply flag is set to 1 indicating 
that a read will follow the write. 
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SCBO 



DATA 
BYTE 
DATA 





>0B,8 

>0040 



DATA OBUFF 



DATA 
DATA 




80 



DATA RBLK 

An example of a reply block is as follows: 
RBLK 



DATA 


RBUFF 


DATA 


40 


DATA 






Write a record to LUNO 8 

The flag word of the SCB indicates that this will 

be an output with reply. 
The record will be written from the memory 

buffer OBUFF. 

80 characters will be written from the memory 

buffer. 
The reply control block is located at RBLK. 



Place the reply in the memory buffer RBUFF. 
Input up to 40 characters. 

The number of characters actually inputed will 
be returned by the system in this data word. 



The following example shows how File Utility Supervisor Call 00 16 assigns LUNO 6 to the diskette 
file DSC: TEXT/SRC. If the file does not already exist it will be created when an OPEN operation 
is performed on LUNO 6. 



SVCBLK EVEN 
BYTE 
BYTE 
BSS 



DATA 
DATA 
DATA 

BSS 

PATHNM BYTE 
TEXT 



>00,>00 
>91,>06 

12 





PATHNM 

12 

16 

'DSC :TEXT 



Assien LUNO 6 to a file. 



Qat ilia niitn./iraota -fl o rr * /-> ^*nn+n „ „„„„„„+: „ 



sequential file. 



PATHNM refers to a memory buffer that has the 
ASCII representation of the file pathname. 



'SRC 



The following example shows an I/O file write operation supervisor call, writing to the logical 
relative record 56 in the relative record file that LUNO 3C, 6 has been previously assigned. 



SCBF 



DATA 





BYTE 


>0B,>3C 


DATA 





DATA 


FILOUT 


DATA 





DATA 


20 


DATA 





DATA 


56 



Write to the file that LUNO 3C 16 is assigned. 

All the flag bits are turned off. 

Write it from the memory buffer FILOUT. 

Unused word. 

Write 20 bytes. 

Write it to record 56 of the relative record file. 
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7.3 SUPERVISOR CALL 15 16 SUPPORT FOR TASKS DESIGNED TO RUN UNDER TX990, 
RELEASE 1.0 

The TX990 Operating System also supports the file utility supervisor call for tasks that were 
generated to run under the 1 .0 version of the TX990 Operating System. 

File utility supervisor call 15 16 performs the following functions: 

• Assigns a LUNO to a device 

• Releases a LUNO assignment. 

7.3.1 SUPERVISOR CALL 15 16 SCB FORMAT. The file utility supervisor call block for file 
utility supervisor call 15 16 consists of 12 bytes aligned on a word boundary. As shown in figure 7-3, 
the content of the supervisor call block is as follows: 



• 1 5 16 (supervisor call code) in byte 



• A byte reserved for a status code, byte 1 

• Utility operation code in byte 2, either of the following: 

01 Assign LUNO to device 
03 Release LUNO assignment 

• User flags in byte 3, as follows: 

Zeros in bits through 4 

File Allocation bit - bit 5. Ignored by TX990. 

File Type — bits 6 and 7, set to zero for a device. 

• LUNO in byte 4 (FF 16 is illegal) 

• Validation identifier in byte 5. Not applicable to TX990. 

• Record length in bytes 6 and 7. Not applicable to TX990. 

• Device name in bytes 8 through 1 1 , consisting of up to four characters left-justified with 
trailing spaces (not required for release function). 

The status codes returned by the system in byte 1 at the completion of the function are listed in 
the error appendix. ■ 

7.3.2 CODING EXAMPLE. The example below assigns LUNO 2 to cassette transport drive 2. 

DATA >1500 Supervisor call code. 

DATA >0100 Assign opcode. 

DATA >0200 Luno. 

DATA 

TEXT 'CS2 ' Cassette drive 2. 
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RELATIVE 
ADDRESS 



10 



1 2 3 4 5 


6 7 





t 


2 


3 


4 


5 


6 7 


1 i i i i — r i 

15 16 


111! 
STATUS CODE 


1 


UTILITY OP CODE 

















AL 


TYPE 


LUNO 


VALIDATION IDENTIFIER 


RECORD LENGTH 


DEVICE NAME, CHAR. 1 


DEVICE NAME, CHAR. 2 


DEVICE NAME, CHAR. 3 


DEVICE NAME, CHAR. 4 



NOTE*. © RETURNED BY SYSTEM. ALL OTHER ITEMS SUPPLIED BY USER AS 
APPLICABLE 



(A)133424 



Figure 7-3. File Management Supervisor Call Block for File Management Supervisor Call 15 16 

7.4 VDT CHARACTER MODE SUPERVISOR CALLS 1 A 16 , 8 16 , and 18 16 . 
With these supervisor calls, the user task can position the VDT cursor, write or read fields of data on 
the VDT screen, and input characters from the VDT keyboard. The following supervisor calls are 
used for character mode operation: 

• VDT Utility Supervisor Call 1 A 16 

• VDT Character Input from Station Keyboard Supervisor Call 8 16 

• VDT Conditional Character Input from Station Keyboard Supervisor Call 18 16 

In the character mode, the user task first executes a VDT utility supervisor call 1A, 6 , to open the 
VDT. Subsequent device I/O operations are performed using character input supervisor calls and 
utility supervisor calls. The VDT is taken out of the character mode by the VDT utility supervisor 
call that specifies the close device I/O operation. 

One or more VDTs may be designated in character mode or record mode, when the system is 
generated. VDTs designated in record mode may also use character mode I/O operations. Character 
mode device I/O operations address the VDT by the station number which is assigned to the VDT 
when the system is generated. 

7.4.1 VDT UTILITY SUPERVISOR CALL 1A 16 . VDT utility supervisor call 1A 16 allows the 
following seven VDT I/O operations with a 91 1 or 913 VDT: 
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Opens the VDT, placing it in the character mode 

Positions the cursor 

Tabs the cursor to an unprotected field on the screen 

Reads a field of characters from the screen 

Writes a field of characters to the screen 

Writes a character in a specified number of character positions on the screen 

Closes the VDT, terminating the character mode. 

One or more of the above VDT I/O operations may be specified in this supervisor call by setting 
a bit to 1 in byte 2 of the supervisor call block. When more than one VDT I/O operation is speci- 
fied, the operations are performed in the sequence indicated in the above list of seven VDT I/O 
operations. 

The open device I/O operation must be performed before any other device I/O operation or super- 
visor call to the VDT. The user task supplies the station number of the VDT to be opened and 
requests the open VDT operation. The result is to enable character mode operation of the VDT. 
When the RC flag is set to 1 , the VDT open operation places the maximum values of row and 
column in bytes 6 and 7 of the supervisor call block, which is normally the buffer address. 

The cursor position VDT operation positions the cursor at any character of any line of the screen. 
The user task supplies the station number of the VDT and the row and column to which the cursor 
is to be moved. 

The tab VDT operation positions the cursor at the leftmost character of an unprotected field. When 
characters are written on the screen, they are written either as protected or as unprotected charac- 
ters. When the cursor is at a position that contains a protected character, the tab VDT operation 
skips protected characters leaving the cursor at the leftmost character of the unprotected field to 
the right of the original position of the cursor. When the cursor is at a position that contains an un- 
protected character, the tab VDT operation moves the cursor to the leftmost character of the 
current unprotected field. The user task supplies the station number of the VDT for the tab VDT 
operation. 

The read characters VDT operation reads a field of characters from the screen at the cursor 
position. The task may specify a number of characters to be read, or may read all the characters in 
an unprotected field. This VDT operation also moves the cursor to the position following the last 
character read. The user task supplies the station number of the VDT, the number of characters 
to be read, and the address of a buffer in which are placed the characters read from the screen. 

The write characters VDT operation writes a field of characters to the screen at the cursor position. 
The task specifies a maximum number of characters to be written. The operation terminates before 
writing the maximum number of characters if the operation detects a character having the most 
significant bit set. In that case, the operation negates the character code, writes the resulting char- 
acter, and terminates. The user task supplies the station number of the VDT, the maximum number 
of characters and the address of the buffer. 
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The write character (propagate) VDT operation writes the first character in the buffer into a field 
of characters on the screen at the cursor position. The task specifies the number of times the char- 
acter is to be written. The user task supplies the station number of the VDT, the number of 
characters to be written, and the address of the buffer that contains the character. 

The VDT close operation must be performed to terminate the character mode of the VDT. The 
VDT may then be opened for record mode operations when the VDT has been designated for both 
modes. The user task supplies the station number of the VDT to be closed. 

The user may specify that the operations of a VDT supervisor call be followed by a beep tone, or 
that the cursor remain disabled following the operations. All device I/O operations return the row 
and column of the cursor position at completion. 

7.4.1.1 VDT Utility Supervisor Call Block. VDT utility supervisor call block, shown in figure 7-4, 
consists of the following: 

• The code, 1 A i 6 , in byte 0. 

• Byte 1 reserved for a completion code (table 4-3). 

• Operation flags in byte 2, as follows: 

PR flag - bit 0, set to one to write protected characters. Set to zero to write un- 
protected characters. 

RC flag - bit 1 , set to one to cause an open VDT operation. The maximum values 
for row and column are placed in bytes 6 and 7 of the supervisor call block. 

PC flag - bit 2, set to one for a position cursor VDT operation. 

T flag - bit 3, set to one for a tab VDT operation. 

R flag - bit 4, set to one for a read VDT operation. 

W flag - bit 5, set to one for a write VDT operation. 

WP flag - bit 6, set to one for a write propagate device I/O operation. 

C flag bit 7, set to one for a close VDT operation. 

• The station number in byte 3. 

• Control flags in byte 4, as follows: 

B flag - bit 0, set to one to provide a beep tone following the operations specified. 
CD flag - bit 1, set to one to disable the cursor following the operations specified. 

• The row, for a position cursor device I/O operation, in bits 3 through 7 of byte 4. The 
range of values is through B, 6 . Returned by the system after each call. 

• The column for a position cursor device I/O operation, in bits 1 through 7 of byte 5. The 
range of values is through 4F lb . Returned by the system after each call. 
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• The address of a buffer in bytes 6 and 7. A read device I/O operation transfers characters 
into the buffer, a write function transfers characters out of the buffer, and a write 
propagate device I/O operation copies the first character in the buffer into one or more 
character positions on the screen. When bit 1 of byte 2 is set to one during an open 
operation, the maximum values of row and column are placed in bytes 6 and 7. 

• The number of characters for a read operation, in bytes 8 and 9. When zero, read the 
entire unprotected field. Otherwise, read the specified number of characters, 

• The maximum number of characters to be written in a write operation, or the number of 
characters to be written in a write propagate operation, in bytes 10 and 11. In a read 
operation, the system returns the actual number of characters read in these bytes. 

The system returns a completion code in byte 1. The codes are listed in table 7-5. 



RELATIVE 
ADDRESS 





1 


2 


3 


4 


5 


6 


7 





12 3 4 5 


6 


7 



PRB REL. 


1 




1 1 1 | 
1A 16 


I I 1 I I 

COMPLETION CODE 


1 

© 


'"■ 


ADDR. 

2 


PR 


RC 


PC 


T 


R 


W 


P 


C 


STATION NUMBER 


4 


B 


CD 




ROW 




COLUMN 


6 


BUFFER ADDRESS 


8 


NUMBER OF CHARACTERS - READ 


10 


NUMBER OF CHARACTERS 



NOTE® RETURNED BY SYSTEM . ALL OTHER ITEMS SUPPLIED BY USER 



(A)1 32858 



Figure 7-4. VDT Utility Supervisor Call Block 
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Table 7-5. VDT Utility Completion Codes 



Code 
(Hexadecimal) 



1 
4 

5 
6 



80 



NOTE1 



Description 

Satisfactory completion. 

Illegal station number. 

Illegal cursor position specified. 

Illegal buffer address (Applies to DX10) 

No unprotected field found in tab function. 

No unprotected field found in read function of 
unspecified length (Note 1) 

VDT currently in record mode or assigned to 
another task. 



When a read function that has no specified length does not read a pro- 
tected field, the full screen of characters is read before the operation is 
terminated in error. Contents of memory locations immediately above 
the buffer are destroyed when the buffer size is less than the screen 
size (960 characters for 913 VDT). (1920 characters for 91 1 VDT). 



7.4.1.2 Coding Example. The following are examples of coding for supervisor call blocks for VDT 
utility calls. 



SCBV DATA >1A00,>A402,>4300,WBUFF,0,8 



SCVCT DATA >1A00>5802,0,RBUFF,5,0 



SCBVC DATA >A100,>2902,>8220,RBUFF,4,0 



Station 2 is already opened, position 
the cursor at column of row 3, 
and write eight protected charac- 
ters from buffer at location WBUFF, 
leaving the cursor disabled. 

Open station 2, tab cursor, and 
read five characters into buffer at 
location RBUFF, with cursor 
enabled. 

Station 2 is already opened, posi- 
tion the cursor at row 2, column 32, 
read 4 characters into buffer at 
location RBUFF, close station 2, 
and sound a beep tone. 
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7.4.2 VDT CHARACTER INPUT SUPERVISOR CALL 8 16 . The character iriput supervisor call, 
code 8 1 6 , inputs a character from a specified station keyboard. The calling task is suspended until 
the character is transferred. The system places the character in the most significant byte of the task 
workspace register 0. The supervisor call block consists of three bytes, and need not be aligned on a 
word boundary. Byte contains the code, and the system returns a value in byte 1. Byte 2 contains 
the station number. When the system is unable to locate the station, it returns -1 in byte 1. When 
the station has not been opened in the character mode, or when power is off at the station, the 
system returns 80 16 in byte 1 . Otherwise, the system returns zero in that byte. 



VDT character input call block: 



(A)1 37501 



STATION NUMBER 



ERROR CODE 



18 16 


ERROR CODE 


STATION NUMBER 





VDT conditional character input call block: 



(A) 137502 

The following is an example of coding for a supervisor call block for a character input from station 
keyboard supervisor call: 



SCBC BYTE 8,0,2 



Input a character from station 2 and place the 
character in the most significant byte of 
workspace register 0. 



7.4.3 VDT CONDITIONAL CHARACTER INPUT SUPERVISOR CALL 8 16 . Conditional 
character input supervisor call 18 16 inputs a character from a specified station keyboard. When a 
character is entered, the function sets the equal bit (bit 2) of the status register to 1 and places the 
character in the most significant byte of workspace register 0. When a character has not been 
entered, the function sets the equal bit of the status register to 0, indicating a "not equal" status. In 
either case, the function returns control to the calling task immediately. The supervisor call block 
consists of three bytes, and need not be aligned on a word boundary. Byte contains the code, and 
the system returns a value in byte 1 . Byte 2 contains the station number. When the system is unable 
to locate the station, it returns -1 in byte 1. When the station has not been opened in the character 
mode, or when power is off at the station, the system returns 80 16 in byte 1 . Otherwise, the system 
returns zero in that byte. 

The following is an example of coding for a supervisor call block for a conditional character input 
from station keyboard supervisor call: 



SCBT BYTE > 18,0,5 



Input a character from station 5 and place it on the 
most significant byte of workspace register if a 
character has been entered at the keyboard. 



7.5 WAIT FOR I/O SUPERVISOR CALL 01 16 . 

Wait for I/O supervisor call 1 i6 places the calling task in suspension pending completion of a 
specified I/O operation. Wait for I/O supervisor call block 01 , 6 contains four bytes aligned on a 
word boundary as shown below. Byte contains the supervisor call code and byte 1 contains a zero. 
Bytes 2 and 3 contain the address of the second word in the supervisor call block that defines the 
I/O operation. When the specified I/O operation is not in progress, control is immediately returned 
to the calling task. 
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(A)t37503 



01 



16 



00 



16 



SCB ADDRESS + 2 



The following example shows coding for a supervisor call block for a wait for I/O call: 

SWBW DATA >100,SCB5+2 Suspend the calling task pending completion of the 

I/O operation defined in the SCB at location 
SCB5. 



7.6 ABORT I/O SUPERVISOR CALL OF 16 OPERATION. 

Abort I/O supervisor call 0F 16 terminates I/O operations on the specified I/O device. The calling 
task is suspended during execution of the abort I/O supervisor call. If the device is file-oriented, it 
becomes unassigned. If the device is busy, the system sets the error flag in the supervisor call block 
for the current operation. No device operation is performed, and the medium remains positioned as 
the last I/O operation left it. That is, tape in a cassette is not backspaced or rewound, nor are the 
remaining cards of a deck read. Abort I/O supervisor call block 0F 16 consists of two bytes which 
need not be aligned on a word boundary as shown below. Byte contains the code and byte 1 
contains the LUNO assigned to the device. 



16 



UJNO 



n 



(A)137504 

The system returns zero as a status code in byte 1 when the operation completes successfully and -1 
(FFi 6 ) when the LUNO specified in the SCB has not been defined. 

The following example shows the coding for a supervisor call block for an abort I/O call: 



SCB A BYTE >F,>11 



Abort I/O to the device to which LUNO 11 16 is 
assigned. 



7.7 ABORT I/O SUPERVISOR CALL BLOCK 1E 16 

Abort supervisor call 1E 16 terminates an I/O operation defined by a specified Supervisor Call Block 
(SCB). The abort operation supervisor call block consists of four bytes aligned on a word boundary 

. _ _i. i.-i r>.,+~ n ~~»,+„;^o +1-,^ ^r^Ac. onH tri<=> cvctpm returns a status Code in bvte 1. BvteS 2 

as M1UWI1 UC1UW. uyit w wjiiiamo lhv wuv, unu li.v ^j^-w*.. » .. - 

and 3 contain the address of the second word in the SCB for the operation to be terminated. 



(A)137505 



IE 



16 



STATUS CODE 



SCB ADDRESS + 2 



The following is an example of coding for a supervisor call block for an abort supervisor call: 

SCBA DATA >1E00 ABORT I/O Operation Abort the I/O operation defined in a 
DATA SCBZ+2 Address supervisor call block at location SCBZ. 
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SECTION VIII 
DISKETTE OCP SYSTEM UTILITY (SYSUTL) PROGRAM 



8.1 INTRODUCTION 

Basically, SYSUTL provides the operator with additional keyboard-command-control capability for 
use with diskette devices and files and, therefore, functions as a diskette-related supplement to the 
Operator Communication Package (OCP), The SYSUTL commands are listed as follows: 

BC - Boot Copy MD - Map Diskette 

SF - Set System File MF - Map File 

CF - Create File DD — Diskette Dump 

DF - Delete File DL - Diskette Load 

CM — Compress File FD - File Dump 

CN — Change File Name FL — File Load 

CP — Change Protection ID — Initialize Date and Time 

DO — Define Output TI — Print Time and Date 

TE — Terminate 
CV - Change Volume Name 

In general, SYSUTL is a module of TX990 and a diskette-resident extension of the OCP module 
(described in Section III of this manual). SYSUTL may be executed under OCP or under the 
Terminal Executive Development System (TXDS) using console control in a manner similar to OCP. 

Tl-ia fV\!1/"m7ii-irr nornrrrnrtVic ^acr»n'Ko +V»o Inorlinfr nrnponnro T TTMllo c\mtov on^ f no inrl i\TiA~t\a% 

commands. The last paragraph in this section covers the SYSUTL error messages. 

8.2 LOADING SYSUTL 

SYSUTL can be loaded using the OCP module or in conjunction with the Control Program. When 
using the OCP module, perform the procedure itemized in paragraph 8.2.1. When using the Control 
Program perform the procedure itemized in paragraph 8.2.2. 

8.2.1 LOADING SYSUTL USING OCP. Load the program as follows: 

1 . After loading the OCP in accordance with the procedure itemized in the section entitled 
Operator Communication Package, observe the printout or display on the system console 
of the period (.) prompt. 

2. Place the object module for SYSUTL in either the cassette or floppy diskette drive and 
ready the device. 

3. Using OCP's LP (Load Program) command, load the SYSUTL object module from 
the input media into memory as follows: 

.LP,DSC2:SYSUTL/SYS Load from floppy diskette DSC2 the object 

module file SYSUTL/SYS. 
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An alternate method for loading the SYSUTL object module from cassette follows: 

.LP,CS1. Load SYSUTL object module from cassette 

unit 1. 

4. Enter OCP'S EX (Execute) command to execute SYSUTL and terminate OCP as follows: 
.EX,10.TE. Executes SYSUTL and terminates OCP 

5 . Observe the following printout or display on the system console : 
TX990 SYSTEMS UTILITY 937544** 

6. After SYSUTL has started execution, the SYSUTL module causes the OP: prompt to 
be printed or displayed on the system console as follows: 

TX990 SYSTEM UTILITY 937544** 
OP: 

7. At this step in the procedure, one or more SYSUTL commands, with a limit of up to 76 
characters on one line, may be entered on the system console. An example follows: 

OP: MD,DSC2.SF,DSC2:SYSFIL/SYS 

NOTE 

All of the commands must be entered on the same OP: line and not 
carried to another line. 

8. After SYSUTL executes the commands entered in the preceding step, observe that the 
OP: prompt is again printed out or displayed on the system console. 

9. At this step in the procedure, the operator has the choice of entering another SYSUTL 
command or terminating SYSUTL by entering a terminate response to the prompt as 
follows: 

OP: TE. 

NOTE 

If an error occurs during execution of a command, the appropriate 
error message is issued. 

10. If TXDS is in the system, observe that SYSUTL has terminated when the following print- 
out or display is produced on the system console: 

TXDS 936215 ** (Date and Time) 

PROGRAM: 
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8.2.2 LOADING SYSUTL USING THE TX990 OPERATING SYSTEM AND THE TXDS 
CONTROL PROGRAM. Load the program as follows: 

1 . After loading the TX990 Operating System in accordance with the loading procedure in 
the section entitled Loading the TX990 Operating System, bid the TXDS Control Pro- 
gram. This can be accomplished by use of the OCP module or without use of the OCP 
module. When the OCP module is used, enter EX,16.TE. in response to OCP's period (.) 
prompt to bid the TXDS Control Program and proceed to the next step. When the OCP 
module is not present, enter an exclamation point (!) to bid the TXDS Control Program 
and proceed to the next step. 

2. Observe the following printout or display on the system console: 
TXDS 936215 ** 359/77 1:00 

PROGRAM: 

3. Enter the pathname of the SYSUTL object module in response to the PROGRAM: 
prompt as follows: 

PROGRAM: :SYSUTL/SYS 

4. Depress the carriage return key and observe that the INPUT: prompt is printed out or 
displayed on the system console. 

NOTE 

The asterisk (*) feature can be used in lieu of the carriage return/ 
NEW LINE entry to by pass the remaining prompts (Input, Output, 
Options). 

5. Make a null entry by depressing the carriage return and observe that the OUTPUT: 
prompt is printed out or displayed on the system console. 

6. Make a null entry by depressing the carriage return and observe that the OPTIONS: 
prompt is printed out or displayed on the system console. 

7. In response to the OPTIONS: prompt, only one SYSUTL command can be entered on 
the system console (with a limit of up to 30 characters on the same line). For example: 

OPTIONS: MD,DSC2 

NOTE 

1. When multiple SYSUTL commands are to be entered, the 
response to the OPTIONS: prompt must be a carriage return 
(i.e., a null entry). This will cause SYSUTL to print or display 
the OP: prompt on the system console to which prompt the 
operator responds with one or more SYSUTL commands (with 
a limit of up to 76 characters on one line). 

2. A SYSUTL command may not be continued on the next line. 
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3. When multiple SYSUTL commands are entered, SYSUTL 
processes each individual command, one at a time, until it has 
no more commands to process, at which time the operator can 
enter a TE (Terminate) SYSUTL command. This, in turn, 
causes the TXDS Control Program to be rebid. 

8. After the SYSUTL command entry is made in response to the OPTIONS: prompt, 
observe that the TXDS Control Program is rebid and the following printout or display 
is presented on the system console:' 

TXDS 936215 ** (Date and Time) 

PROGRAM: 

8.3 LUNOs 

SYSUTL uses LUNO 0, LUNO 6, and LUNO 7. LUNO is assigned to the system console. All com- 
munications between operator and task, including error messages, are performed through LUNO 0. 
LUNO 6 is assigned by SYSUTL to the diskette being accessed by all diskette-related commands. 
LUNO 7 is internally assigned to the default print device upon loading SYSUTL and is used as 
the SYSUTL output LUNO for any printer output. The user has the option to redirect any printed 
output, excluding error messages, to a device other than the LOG by executing the Define Output 
(DO) command (described in one of the paragraphs below). 

8.4 SYSUTL COMMAND FORMAT AND SYNTAX 

Each command consists of a command word, optionally followed by one or more operands. 
SYSUTL recognized a command by the first two letters of the command word, the command key. 
These letters may be followed by additional letters or by blanks. One or more blanks, or a comma, 
may separate a command key and its operands. However, embedded blanks are not allowed within 
the command word or an operand. 

If Systems Utility is executed using OCP, more than one command may be entered in a single line, 
which may contain up to 72 characters and must be terminated by a carriage return (NEW LINE on 
913 VDT). When more than one command is entered on a line, each command must be terminated 
with a period, except the last command on the line, then it may be omitted. When an error is 
detected in a command, any subsequent command on that line is ignored. 

SYSUTL syntax also entails the following items and/or rules: 

Angle brackets < > enclose items required to be supplied by the user 
Brackets [ ] enclose optional items 

Braces { } enclose alternative items, one of which must be entered 
An ellipsis (. . . .) indicates that the preceding items may be repeated 
Items shown in capital letters must be entered as shown 
Pathname is described in 1.4. 1 . 
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8.5 SYSUTL COMMANDS 

SYSUTL provides commands to initialize the time and date and to display the time and date. 
SYSUTL also provides a command to define a listing device for the display commands. All the re- 
maining commands deal with functions that involve the diskette. SYSUTL has a command to in- 
voke every file utility operation: create a file; delete a file; compress a file; change a file name; and 
change protection on a file. SYSUTL also supports maintenance functions for the diskette: map the 
diskette, which displays the file names along with various information of all the files on the 
diskette; map file, which displays information for a single file; disc dump, which displays absolute 
locations on the diskette; disc load, which writes to absolute locations on the diskette; file dump, 
which displays physical sectors within a file; and file load, which writes to physical sectors within 
a file. 

SYSUTL provides two commands for maintenance of a system diskette. The first command is 
Boot Copy (BC) which copies the TXBOOT program to diskette. The second command is Set 
System File (SF), which allows the user to define any object file as the file that will be loaded as 
the Operating System. The system file pathname must be defined before the Operating System 
loading procedure is performed. (Refer to the loading procedure in Section II of this manual for 
additional information.) 

If a null entry is made wherever a device is to be specified, the default-substitute will be the system 
diskette which is specified during system generation. There will be no other defaults. 

All numeric output is in decimal except the output from the Diskette Dump (DD) and File Dump 
(FD) commands. These dumps are in hexadecimal. 

8.5.1 BOOT COPY (BC). The Boot Copy (BC) command causes a copy of the TXBOOT program 

j. _ i- - :ii xi- -r:_ j j_-_i._j.x_ a j:-.i._j-*_ Ttrwx i i 4- u„ J x„ i j xi r\ -t-: 
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System or a stand-alone program from diskette until the TXBOOT program is written to the diskette 
that will be used during loading. The syntax of the command is presented as follows: 

BC, (<device>. \ 
\<volume>.( 

The operand must be a one-to-four-character diskette or volume name. There is no 
default-substitute for the device operand. Upon executing the BC command, the TXBOOT program 
is copied to physical tract of the specified diskette. The following is an example of the Boot Copy 
(BC) command: 

OP:BC,DSC2. The TXBOOT program is copied to physical track 

0ofDSC2, 

8.5.2 SET SYSTEM FILE (SF). The Set System File (SF) command defines a diskette file to be 
loaded as the Operating System or as a stand-alone program. The syntax is as follows: 

SF,<pathname>. 

The file designated by the specified pathname is the file that contains the linked object code that is 
to be loaded and executed as the Operating System or as a stand-alone program. Refer to the 
diskette/cassette ROM loader description for further details on loading. An example of the Set 
System File (SF) command follows: 

OP:SF,DSC:TX990/SYS. The file TX990/SYS on DSC is to be used as the 

Operating System file when the diskette is booted. 
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8.5.3 CREATE FILE (CF). The Create File (CF) command creates a sequential or relative record 
file. The syntax for the command is as follows: 

CF,<pathname>,[,<RR>,<record length>] . 

The pathname operand is the name assigned to the file upon its creation. The newly created file is a 
noncontiguous sequential file unless the optional operand 'RR' follows the pathname. If 'RR' is 
specified, the file is created as a noncontiguous relative record file with the specified record length. 
For relative record files, the recrod length must be given. Record length is assumed to be decimal 
unless preceded by '>'. All files are created unprotected and have a protection code of 'U'. 

The following are examples of the CF command: 

OP:CF,DSC2:FILE/SEQ. Create sequential file named 'FILE/SEQ' on DSC2. 

OP:CF,VOL1:RELREC,RR>80. Create relative record file names 'RELREC with 

record length of 80i 6 on the diskette with the 
volume name VOL1 . 

8.5.4 DELETE FILE (DF). The Delete File (DF) command deletes the specified file from the 
diskette. The syntax for the command is as follows: 

DF,<pathname>. 

The following question is issued: 

ARE YOU SURE??? 

Only one character is accepted. If any response is entered other than a 'Y' for 'yes', the delete file 
command is ignored. Upon entering a 'Y', the specified file is deleted from the diskette. An 
example of the DF command follows: 

OP:DF,DSC:TEMPFIL 

ARE YOU SURE??? Y Upon entering 'Y\ the file 'TEMPFIL' is deleted from 

DSC. 

8.5.5 COMPRESS FILE (CM). The Compress File (CM) command returns to the Operating System 
all allocation units (AUs) beyond the EOF for the specified pathname. 

CM,<pathname>. 

The pathname operand must be a valid pathname as defined in the section in this manual entitled 
File Management Executive Supervisor Calls. The Compress File command compresses the desig- 
nated file to its minimum size. The following is an example of the CM command : 

OP: CM,:OCPFIL/SRC. Compresses file 'OCPFIL/SRC on system default diskette. 

8.5.6 CHANGE FILE NAME (CN). The Change File Name (CN) command changes the file name 
and extension of an existing file to the new pathname as specified. The syntax of the command is as 
follows: 

CN,<old pathname>,<new pathname>. 
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Both the old pathname and new pathname operands must be valid pathnames as defined in section I 
of this manual. The file with the specified old pathname retains all its directory information such as 
protection code and file type. Only the name of the file on the diskette is changed. The following 
is an example of the CN command: 

OP: CN,DSC2:OCPFLl,DSC2:OCPFIL/SYS. Changes the name of the file that is cur- 

rently listed in the file directory on DSC2 
as OCPFL1 to the new file name OCPFIL/ 
SYS. 

8-5.7 CHANGE PROTECTION (CP). The Change Protection (CP) command changes the file 
protection code of the specified file to the new protection code. The syntax of the command is 
as follows: 

'u 

CP,<pathname>, \ D 
W 

The pathname operand must be a valid pathname. The existing protection code of the specified 
file is changed to the newly defined protection code. The second operand is a one-character 
abbreviation of the possible protection code as follows: 

U — Unprotect File (File is Unprotected) 

D - Delete Protect File (Protects File from Being Deleted) 

W - Write Protect File (Protects File from Being Written On or Deleted) 

If the specified file is already open, the new protection will not be in effect until the file is closed. 

The following is an example of the CP command: 

OP: CP,DSC:LIST80/SYS,W. Protects the file 'LIST80/SYS' on DSC from being written 

over or deleted. 

O C O rvT?rr'TTVTT7 rvf tttji tt /T\n\ nrt T\~r:„„ /~\. . + „..+ /"T^v/~4\ „„«,„,„,*, A j:~,-.„+„ +U^ ^i; n «ln,^ ^f o^.r^r-^l 
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SYSUTL commands to the specified device. The syntax of the command is as follows: 
DO,<device>. 

All displays are directed to the default print device until changed. The DO command allows the 
printed output of the following commands to be directed to the specified device: 



MD - 


Map Disc 


MF - 


Map File 


DD - 


Disc Dump 


FD - 


File Dump 


TI - 


Print Time and Date 


ID - 


Initialize Date and Time 
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The device operand is a one- to four-character device name. 

If SYSUTL is terminated and then rebid without reloading, the use of the last output device 
assigned will be resumed. The following is an example of the DO command: 

OP: DO,LP. Redirects all displays (excluding error messages) to the line 

printer until the DO command is reexecuted. 

OP: DO. Displays are resumed to the default print device, which 

is the system console for standard TI supplied Operating 
Systems. 

8.5.9 MAP DISKETTE (MD). The Map Diskette (MD) command maps the specified diskette by 
file name, by extension, or maps every file on the diskette to the display device. The syntax for the 
command is as follows: 



MD 



f<device> ) 
|<volume>/ 



{,<extension>) 
<file name> f 



If no device is specified, the operating system diskette is used. The device operand is a one- to four- 
character device name that is to be mapped. The extension operand consists of a slash immediately 
followed by a one- to three-character extension name which will be used to map the diskette. To 
map the diskette according to a specified file name, a colon must be entered and immediately fol- 
lowed by a one- to seven-character file name. 

The Map Disc command outputs the Diskette Identification field, the total number of allocation 
units on the specified diskette, and the number of available and bad Allocation Units (AUs) on the 
diskette. MD also lists the name of all files on the diskette, their file type, file protection code, and 
the total number of AUs allocated to each file. The command output is terminated with the print- 
ing of the time and date. 

The following are examples of legal MD commands: 

MD,DSC2:FILE/. Map all files with the name FILE and any extension 

on DSC2. 

MD,VOL2:FILE/. Map all files with the name FILE and any extension 

on the diskette with volume name VOL2. 

MD,VOL/OBJ. Map all files with the extension OBJ on volume VOL. 

MD,/SRC. Map all files on the default disc with the extension 

SRC. 

MD,VOL3 . Map all files on volume VOL3 . 

MD,:TASK1/. Map all files on the default disc with the name 

TASK1 and any extension. 

It is not legal to give both a file name and an extension in a Map Diskette command. 
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The output of the MD command may be directed to any desired device using the Define Output 
command. Output of the MD command is sorted alphabetically by file name and extension. The 
following are examples of the Map Disc command: 



OP: MD. 



Maps all of the default diskette. 



DISC I. D. : TX990 1/27/77 
DSC ALLOC. UNITS(TOTAL): 333 FREE: 

FILE TYPE PT ALLOC. UNITS 



18 
20 



JAD: 



DSKDMT/SYS 


S 


U 


IBMUTL/OBJ 


s 


U 


SCRATCH/SRC 


s 


U 


SCRTCH 


s 


U 


SOURCE/SRC 


s 


U 


SYS012 


s 


U 


SYS0127/SYS 


s 


1 1 

u 


TEMP/SRC 


s 


u 


TEMP/TMP 


s 


u 


TXEDIT/SYS 


s 


u 


TXTST1/SRC 


s 


u 


TXTST2/0BJ 


s 


u 


TXTST3/0BJ 


s 


u 


10:45:35 


FEB 3, 


1977 


OP: MD,/SYS. 







102 



102 

8 

7 

22 



Maps all files on default diskette with the extension 'SYS'. 



DISC I. D. : TX990 1/27/77 



nsr 






ai i nr IIMTTC^TOTAI ^ m 



TYPE PT ALLOC. UNITS 



DSKDMT/SYS 


S 


U 


18 


SYS0127/SYS 


S 


u 


102 


TXEDIT/SYS 


S 


u 


22 



10:46:08 



FEB 3, 1977 



8.5.10 MAP FILE (MF). The Map File (MF) command outputs pertinent information of the 
specified file to the defined output device. The syntax for the command is as follows: 

MF,<pathname>. 
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The pathname operand specifies the name of the file that is to be mapped and the device on which 
it is located. This command displays the type of file, whether sequential or relative record, the 
file-protection code, the record length if it is a relative record file, and the number of allocation 
units (AU) contained in the file. The MF command also outputs the starting allocation unit num- 
ber and the number of units contained in each block allocated to the specified file. The command 
output is terminated with the printing of the time and date. The following are examples of the Map 
File (MF) command for a sequential record file. 

OP: MF,DSC:DSKDMT/SYS. Map file 'DSKDMT/SYS' on diskette DSC. 

NAME: DSKDMT/SYS TYPE:S PT:U REC LENGTH: # A. U. : 18 

START ALLOC. UNIT # OF UNITS 

200 16 

240 2 

10:46:52 FEB 3, 1977 

8.5.11 DISKETTE DUMP (DD). The diskette Dump (DD) command causes SYSUTL to print the 
contents of the specified absolute diskette locations on the defined display device. The syntax for 
the command is as follows: 

DD[ , <device>] ,<alloc unit>,<sector>[,<start byte>[,<end byte>] ] . 
DD,T[,<device>] ,<track>,<sector>[,<start byte>[,<end byte>] ] . 

The Diskette Dump command may be executed in either of two modes: by allocation unit or phys- 
ical track. If the diskette is to be accessed by track, a "T" must be entered immediately after the 
command key 'DD'. The optional device operand is a one- to four-character name. If the device 
operand is omitted, the default system diskette as specified during system generation is used. The 
allocation unit operand is a one- to three-digit number that specifies the desired allocation unit. 
If the dump is to be performed by physical diskette track, the track operand is a one- to two-digit 
number that specifies the desired track. The sector operand is a one- to two-digit number that 
designates a sector on the allocation unit or track. The next two operands are one- to four-digit 
numbers that specify the starting and ending byte addresses within the sector to be printed. When 
only the starting byte is entered, the contents of the word that contains the specified byte as well 
as the remainder of the sector, are printed. When both the starting and ending byte addresses are 
omitted, the contents of the entire sector are printed. 

All numeric operands (allocation unit, track, sector, starting and ending byte) are assumed to be 
decimal unless otherwise ' preceded by a '>' for hexadecimal. The following is an example of the 
Diskette Dump (DD) command and the resulting printout: 

OP: DD,12,0,>10,>30 Dumps sector of allocation unit 12, byte 10 16 through 

30 16 on default diskette. 

0010 3641 3043 3043 3041 4231 3030 3837 4631 6A 0C 0C 0A Bl 00 87 Fl 
0020 3445 4620 5458 3939 3030 3535 FF42 3036 4E F TX 99 00 55 .B 06 
0030 4130 A0 

10:47:41 FEB 3, 1977 
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The contents of sixteen bytes are printed per line following the address of the first byte printed on 
the line. The contents of each pair of bytes are shown as four hexadecimal digits. At the right end 
of the line, the contents are printed as ASCII characters. The bytes that contain values that corre- 
spond to printable ASCII characters are translated and printed as ASCII characters. The nonprinting 
ASCII characters are printed as periods. The display is terminated with the printing of the time and 
date. 

8.5.12 DISKETTE LOAD (DL). The Diskette Load (DL) command places the specified data on 
a diskette at a specified address. The Diskette Load command may be performed by allocation units 
or by physical track. The syntax for the command is as follows: 

DL [,<device>] ,<allocation unit>,<sector>,<starting byte>,<data>[,<data>...] 
DL,T[,<device>] ,<track>,<sector>,<starting byte>,<data>[,<data>....] 

If the diskette is to be accessed b> .rack, a 'T' must be entered immediately after the command key 
'DL'. The optional device operand is a one- to four-character device name. If the device operand is 
omitted, the default-substituted system diskette as specified at SYSGEN time is used. The 
allocation-unit operand is a one- to three-digit number which specifies the allocation unit to be ac- 
cessed. A number consisting of one to two digits is entered for the track operand if the diskette is 
to be accessed by physical track. The sector is a one- to two-digit number that specifies a sector on 
the allocation unit or track that is to be loaded. The starting byte is a one- to four-digit byte address 
into which the first data value is placed. If the byte address is odd, the previous even-byte address 
will be used. When additional words of data are entered, they are placed in successive addresses. 

All numeric operands (allocation unit, track, sector, starting byte, data) are assumed to be decimal 
unless otherwise preceded by a '>' for hexadecimal. The following is an example of a Diskette 
Load (DL) command: 

OP: DL,DSC2,1,3,>20,>5448>4453,32,57. Place the ASCII codes for the characters 

T, X, D, and S in bytes 20 16 through 
23 16 and decimal data in bytes 24 16 
through 27 16 of sector 3 of allocation unit 
1 onDSC2. 

CAUTION 

The DL command has the capability of modifying any data on the 
system diskette, including the Operating System file and Operating 
System file structures. Verify the address by performing a DD com- 
mand that specifies the same allocation unit or track, and sector be- 
fore entering a DL command. When the contents do not agree with 
the contents of the bytes to be altered, determine the correct AU 
track and sector before proceeding. 

8.5.13 FILE DUMP (FD). The File Dump (FD) command causes SYSUTL to print the contents 
of a specified physical sector of a specified diskette file. The syntax of the command is as follows: 

FD,<pathname>,<sector>[,<starting byte>[,<ending byte>] ] . 

The pathname operand specifies the name of the file and the diskette unit on which it is located 
that is to be dumped. The sector operand is the number of the sector that is to be accessed relative 
to the beginning of the file. The next two operands, the starting and ending byte, are one- to four- 
digit addresses within the sector to be printed. When only the starting byte is entered, the contents 
of the word that contains the specified byte are printed. When the byte addresses are omitted, the 
contents of the entire sector are printed. The contents are printed in hexadecimal representation 
and in ASCII character representation, A nonprinting character is represented by a period. The dis- 
play is terminated with the printing of the time and date. 
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All numeric operands (sector, starting byte, ending byte) are assumed to be decimal unless other- 
wise preceded by '>' for hexadecimal. The following is an example of a File Dump (FD) command 
and the resulting output: 

OP: FD,DSC2:SYSUTL/SYS,1„>36. Dumps sector 1, bytes through 36 16 of 

file SYSUTL/SYS on DSC2. 

8.5.14 FILE LOAD (FL). The File Load (FL) command places the specified data in specified 
bytes of a diskette file record. The syntax for the command is as follows: 

FL,<pathname>,<sector>,<starting byte>,<data>[ ,<data>.... ] 

The pathname operand specifies the name of the file and the diskette unit on which it is located 
that is to be accessed. The sector operand is a one- to two-digit number presenting the sector to 
be loaded relative to the beginning of the file. The starting byte is a one- to four-digit address into 
which the first data value is placed. When an odd number is entered for the starting byte, the value 
is placed in the even address immediately preceding the odd value. When additional words of data 
are entered, they are placed in successive addresses. 

All numeric operands (sector, starting byte, data) are assumed to be decimal unless otherwise 
preceded by a '>' for hexadecimal. The following is an example of an FL command: 

OP: FL,DSC:TEMPFIL,2,0,>444D,>4879. Places 444D 16 and 4879 16 into bytes 

through 3 of the second sector in 
TEMPFIL on DSC. 

8.5.15 INITIALIZE DATE AND TIME (ID). The Initialize Date and Time (ID) command 
initializes the date and time values for the system. The syntax for the command is as follows: 

ID,<year>,<month>,<day>,<hour>,<minute>. 

The year operand is the four-digit decimal number of the years 1976 through 1999, and the month 
operand is the decimal number of the month 1 through 12. The day operand is a one- or two-digit 
decimal number, 1 through 31, and the hour operand is a one- or two-digit decimal number, 
through 23. The minute is the decimal number of the minute through 59. The second is set to 
zero when the command is entered. An example of an ID command follows: 

OP: ID,1977,2, 12, 17,29 Initialize the time and date to 5:29 PM, February 12, 1977. 

17:29:00 FEB 12, 1977 

8.5.16 PRINT TIME AND DATE (TI). The Print Time and Date (TI) command causes SYSUTL 
to print the time and date. The syntax for the command is as follows: 

TI. 

The command requires no operands. The following example^hows a TI command and the resultant 
output . 

OP: TI. 

9:29:12 FEB 13, 1977 
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When the date and time have not been initialized, no date is printed and the time printed is the 
elapsed time from the most recent loading of the Operating System or from system restart. 

8.5.17 TERMINATE SYSUTL (TE). The Terminate SYSUTL (TE) command terminates execu- 
tion of SYSUTL and releases all related LUNOs. If the TXDS Control Program is linked with the 
TX990 Operating System, it will be rebid. The syntax for the command is as follows: 

TE. 

The command requires no operands. 

8.5.18 CHANGE VOLUME NAME (CV). The change volume (CV) command causes SYSUTL to 
change the volume name of a diskette to a new volume name. The syntax for the command is as 
follows: 



CV, [ <device> 
[ <volume> 



<volume>. 



The first parameter defines the old volume name or device. The second parameter defines the new 
volume name. It is wise to avoid volume names that are also device names, because the TX990 
operating system will not be able to find the correct volume. 

When a volume name for a disc has not been defined, it may be defined by using the device name, as 
follows: 

CV,DSC2,VOL2. 

8.6 SYSUTL ERROR MESSAGES 

The error messages capable of being issued by SYSUTL are listed in table 8-1. When more than one 
SYSUTL command is entered on a line and an error occurs, the command in error (or that caused 
the error) and all subsequent commands in the statement must be entered again. Unless otherwise 
noted, when an error occurs, the command is ignored and SYSUTL prompts for input. 
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Message 
♦INVALID COMMAND* 

I/O ERROR, IGNORED 



Table 8-1. SYSUTL Error Messages 
Meaning 

The command word is not valid. 



An I/O error was detected during 
reading of the command. 



Recovery 

Check the command word, and re- 
enter correctly. 

Input from the system console was not 
received correctly. Check the device, 
and reenter the entire line. 



OUTPUT ERROR 



UNDEFINED ERROR 



OPERAND ERROR(S) 



BAD DEVICE 



DEVICE OFF LINE 



An error was detected during output 
and execution of the command has 
been terminated. 



TX990 returned an error code to 
SYSUTL that is not recognized by 
SYSUTL. 

One or more operands are invalid. 



Invalid device name. 



Specified device not on line. 



This message is printed when the user 
has entered an ESC character to ter- 
minate output, or if LUNO 1 has not 
been assigned. If neither of these 
applies, check device for errors. 

This is a system error. Make another 
attempt to enter the command. If 
error recurs, reinitialize the system. 

When a required operand has been 
omitted, enter the complete com- 
mand. When a numeric operand is re- 
quired, but a nonnumeric operand was 
entered, enter the command with the 
correct type of operand. 

Enter the command with one of the 
device names assigned when the sys- 
tem was generated. 

Check diskette device. If power off or 
diskette not installed in drive, correct 
and reissue command. 



INVALID DISC 
ADDRESS 

BAD FILE NAME 



INVALID INPUT 
PARAMETER 



Invalid track, AU, or sector 
specified. 

Specified pathname has a syntax 
error. 

Bad parameter in supervisor call 
block. 



Check command operands and reenter 
correctly. 

Check pathname input and reenter 
correctly. 

Reload and execute SYSUTL. 



DUPLICATE FILE NAME 



File already exists with specified 
filename. 



Check file name and reenter correctly. 



FILE NAME UNDEFINED 
DISKETTE FULL 



Specified file does not exist. 

No available allocation unit or 
diskette. 



Check file name and reenter correctly. 

Delete any unnecessary files and/or 
compress files. Printer command. 
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Message 

FILE DELETE PRO- 
TECTED — UNABLE 
TO DELETE 

INVALID FILE PRO- 
TECTION SPECIFIED 



Table 8-1. SYSUTL Error Messages (Continued) 
Meaning 



Delete File command. Attempted 
to delete file that is write-protected 
or delete-protected. 

Change File protection command. 
Protection specified is not valid 
character: 'U\ 'D\ or 'W. 



Recovery 



If you wish to delete the specified file, 
it must first be unprotected. 



Reenter file-protection code. 



UNABLE TO READ DISC 



Error occurred while reading 
diskette. 



Reenter command. 



UNABLE TO WRITE DISC 



Error occurred while writing to 
diskette. 



Reenter command. 



CAN'T OPEN OUTPUT 
LUNO 



SYSUTL output LUNO is already 
in use by another task. 



If a record mode I/O-operation to the 
LUNO is in progress, enter the com- 
mand again after the operation is com- 
pleted. If the LUNO is assigned to a 
file-oriented device that has been 
opened, enter the command again 
after the LUNO has been closed. 



CANT LOAD FAST h'tiD 
OF SECTOR 

UNABLE TO GET 
REQUIRED MEMORY 



Diskette Load or file Load command. 
Specified sector not in range of file. 

Memory required to execute speci- 
fied command is not available. 



uiecK desired sector numoer and 
reenter command correctly. 



UNABLE TO GET COMMON 



FILE DIRECTORY EMPTY 



Error occurred in trying to get 
TOMMON 



Map Diskette command. Attempted 
to map a diskette which has no files 
on it. 



Verify that TX990 has COMMON. If 
not the s v stem must be re°enerstsd 
to include COMMON. 

Check device name and reenter corr- 
rectly. 



INPUT PARAMETER OUT 
OF RANGE OF SECTOR. 



Byte address specified not in range 
of sector. 



Check input and reenter command 
correctly. 
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SECTION IX 
SYSTEM GENERATION 



9.1 INTRODUCTION 

The GENTX utility program provides the user with the capability of generating an operating system 
customized to the user's specific hardware and software configuration. Basically, the customized 
operating system is generated as follows: 

• First, GENTX is used to produce source code for two source modules: TXDATA and 
TASKDF. The TXDATA source module is used for providing the data needed by the 
operating system to enable its communicating with (i.e., controlling) each device in the 
user's total hardware configuration. (Whenever another device is added to the user's 
hardware configuration, it is necessary to add data to the TXDATA source module.) The 
TASKDF source module is used for providng the data needed by the operating system to 
enable execution of any of the various Tl-supplied modules/tasks (e.g., File Management, 
Operator Communications Package, Start Task, Diagnostic Task, etc.) or of any 
user-supplied tasks/programs (including user-utilities). 



• 



Second, an assembler is used to assemble the TXDATA and TASKDF source modules 
into object modules. 

• Third, a linker is used to link TXDATA and TASKDF object modules to other selected 

OOjeci II1UUIUC5 suui as a usci uaai^/piogiam, tn<u j. xiv ii±txiia.^.in\>in. uuui.; f^S 11 ""! ViiV ' 

Operator Communications Package, Start Task, Diagnostic Task, etc. This linked object 
module is the resultant customized Operating System. 

The following paragraphs describe these steps in detail. 

9.2 PREPARATION FOR GENERATING A TX990 OPERATING SYSTEM 

In preparation for generating a customized TX990 operating system, the user must select the 
peripheral devices to be included in his system and assign Communications Register Unit (CRU) 
addresses and interrupt levels for each of those devices which can be obtained from the chart that is 
pasted on top of the Model 990/4 or Model 990/10 computer chassis. 

The user must write and assemble a Device Service Routine (DSR) for each type of device not 
supported by any of the Tl-supplied TX990 modules. The DSR must process interrupts generated 
by the device and I/O calls to the device. The devices supported by Tl-supplied modules are listed 
in Section I. The user must also write and assembly and user-supplied routines (e.g. supervisor calls, 
extended operations) and include the object code when linking the system. Appendix C contains 
detailed information about writing such routines. 

9.3 DEFINING THE NEW SYSTEM 

Definition of a new operating system is accomplished by executing the GENTX utility program. 
GENTX prompts the user to define various parameters, as well as devices connected in the system. 
After all parameters have been defined GENTX builds two source modules, TXDATA and 
TASKDF, which form part of the operating system kernel. 
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9.3.1 LUNOS USED BY GENTX. GENTX uses the system console for user interactions and 
LUNO 10i 6 for file output. 

9.3.2 LOADING AND EXECUTING SYSTEM GENERATION (GENTX) UTILITY PROGRAM. 

GENTX may be loaded and executed using a TX990 or DX10 Operating System. The following 
paragraphs describe how to load and execute GENTX using a TX990 Operating System, or TXDS, 
or DX 10 release 2.2 system. 

9.3.2.1 Loading and Executing Using TXDS. When executing GENTX using TXDS Control 
Program in a system without OCP, place the GENTX object module in the appropriate input device 
and perform the following steps: 

1. Enter an exclamation point (!). 

2. Enter the GENTX pathname to the "PROGRAM:" prompt as follows: 

PROGRAM: :GENTX/SYS* If the object program for GENTX is in diskette 

file, :GENTX/SYS. 

PROGRAM : CS 1 * If on Cassette 1 . 

PROGRAM: CR* If on Card Reader. 

After GENTX starts executing it will display the following title message: 

TX990 SYSTEM GENERATION 945673 *B 

9.3.2.2 Loading and Executing GENTX with TX990 Using OCP. When executing GENTX on a 
TX990 system using OCP, place the GENTX object module in the appropriate input device and 
perform the following steps: 

1. Enter an exclamation point (!) at the keyboard of the system console to activate OCP. 
OCP responds by printing a period (.) to request a command. 

2. Enter an OCP command to load GENTX in the dynamic task area. The following are 
examples of commands to load GENTX: 

.LP,CS1,3. Load task GENTX at priority level 3 when the 

object module is on Cassette Unit 1 . 

.LP,CR,3. Load task GENTX at priority level 3 when the 

object module is in the Card Reader. 

.LP,:GENTX/SYS. Load task GENTX at priority level 3 when the 

object module is in diskette file. 

3. Enter the following OCP command to execute GENTX and terminate OCP: 

.EX,10.TE. Execute the task in the dynamic task area, 

GENTX and terminate OCP. 



9"2 Digital Systems Division 




946259-9701 



After GENTX starts executing it will display the following message: 

TX990 SYSTEM GENERATION 945673 *B 

9.3.2.3 Loading and Executing GENTX with DX10 Release 3.0. For details on the DX10 release 
3.0 process, refer to Appendix K. 

9.3.3 DEFINITION PHASE. GENTX begins execution in the definition phase, in which GENTX 
requests the user to enter system parameters and constructs an internal table of data from which 
GENTX later constructs the source statements for TXDATA and TASKDF. GENTX prints the 
request on the system console, and the user enters the parameters on the keyboard of the same 
device. In the following paragraphs, numeric parameters are specified as hexadecimal or decimal 
numbers according to the type of number that normally would be used. Either hexadecimal or 
decimal values may be entered for any numeric parameter. A hexadecimal number is preceded by a 
greater-than (>) character. If at anytime the user wishes to terminate GENTX, enter an asterisk. 
Table 9-1 shows all of the prompts which may be displayed by GENTX, and gives information 
concerning correct replies. The following paragraphs describe each prompt. 

9.3.3.1 General System Definitions. The first prompt displayed by GENTX is as follows: 

MEMORY AVAILABLE- 

The user enters the amount of memory (bytes) available to GENTX, to be used for table storage. 
No default when only a carriage return is entered. The total memory available may be calculated 
by subtracting the size of GENTX (2B65 16 bytes) from the total memory available. The suggested 
memory allocation is 2000 10 bytes. 

The next six prompts are requesting timing information that will be used by the task scheduler 
within the new TX990 Operating System being generated. 

LINE FREQ.- 

The user enters the power-line frequency, a decimal value followed by a carriage return. The valid 

puiuinvwiu mv/ ^j\j iui *j\j xii; j;unvj mil. nmunivjf ui kj\j iui \j\j~lll. j;uv»tl"iilH/ nvi|UClltJ. TTilCll a 

carriage return only is entered, GENTX uses the default value, 60. 
The next request is as follows: 
TIME SLICE - 

The user enters the number of real-time-clock cycles per maximum time period, followed by a 
carriage return. The maximum time period is used for a time slice by the task scheduler. When only 
a carriage return is entered, GENTX uses the default value, 6, corresponding to a 50-ms time slice 
when the power-line frequency is 60-Hz, or a 40-ms time slice when the power-line frequency is 
50-Hz (see table 9-2). 

The next four requests ask for the maximum number of consecutive time slices for priority level 
0-3. If a priority level exceeds its maximum number of consecutive time slices, the task scheduler 
will give a time slice to a task at a lower priority, therefore, preventing lockouts of low priority 
tasks. The highest priority level is level 0; its weighting factor is requested as shown below. 

PL WT.FACTOR- 
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Request 
MEMORY AVAILABLE - 
LINE FREQ. 
TIME SLICE 
PL - 3 WT. FACTOR 
COMMON SIZE 

# OF EXP CHASSIS 
CHASSIS 1 - 4 INT LEVEL 



CHASSIS 5 - 7 



CHASSIS 

DEV NAME 

DEV TYPE 

LEFT CASS/PTP NAME 

RIGHT CASS/PTR NAME 

STATION # 

CRU BASE ADDR 

ACCESS MODE 

INT LEVEL 



Table 9-1 . GENTX Prompts 
Range 

Note 7 

50 or 60 

Note 1 

Note 1 

Primarily limited 
by size of available 
memory. 

1-7 

3,4,6,7 
(990/4) 
3,4,6-15 
(990/10) 

3,4,6,7 
(990/4) 
3,4,6-15 
(990/10) 

0-7 

Note 2 

Listed in table 7-3. 

Note 2 

Note 2 

1 - 127 

0->lFFE 



FILE,RECORD, 
or CHARACTER 

3,4,6,7 
(990/10) 
3,4,6-15 
(990/10) 



Default 



none 



60 
6 
10 




Discussed in 
Paragraph 

9.3.3.1 

9.3.3.1 

9.3.3.1 

9.3.3.1 

9.3.3.1 






9.3.3.1 


None 


9.3.3.1 


None 




None 


9.3.3.1 


None 




None 


9.3.3.2 


None 


9.3.3.2 


None 


9.3.3.2 


None 


9.3.3.2 


None 


9.3.3.2 


None 


9.3.3.2 


Device de- 


9.3.3.2 


pendent 




Listed in 


9.3.3.2 


table 7-3. 




Device de- 


9.3.3.2 


pendent 
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Table 9-1 . GENTX Prompts (Continued 









Discussed in 


Request 


Range 


Default 


Paragraph 


INT POSITION 


0- 15 


None 


9,3.3.2 


TIMEOUT COUNT 


Note 1 


Device de- 
pendent 


9.3.3.2 


# OF DRIVES 


1 -4 




9.3.3.2 


CRU INT LINE 


0-31 


15 


9.3.3.3 


ENTRY LABEL OF DSR 


Note 3 


None 


9.3.3.3 


ENTRY LABEL OF ROUTINE 


Note 3 


None 


9.3.3.3 


INT BRANCH LABEL 


Note 3 


None 


9.3.3.3 


EXTENSION DATA 


Note 3 


None 


9.3.3.3 


svc# 


Note 4 


None 


9.3.3.4 


ENTRY LABEL 


Note 4 


None 


9.3.3.4 


XOP# 


1 -14 


None 


9.3.3.5 


WORKSPACE LABEL 


Note 5 


None 


9.3.3.5 


ENTRY LABEL 


Note 5 


None 


9.3.3.5 


TASK ID # 


0-OF, 
11 -FE 


None 


9.3.3.6 


PRIORITY LEVEL 


Note 6 


None 


9.3.3.6 


INITIAL DATA LABEL 


Note 6 


None 


9.3.3.6 


MULTIPLE DYNAMIC TASKS (Y OR N) 


YorN 


None 


9.3.3.6 


#OF DYNAMIC TASKS 


1 -256 


None 


9.3.3.6 


# OF PROCEDURES 


0- 128 


None 


9.3.3.6 


CONSOLE DEV NAME 


Device name of a 
733 ASR, 733 KSR, 
911 VDT,or913 
VD1 


None 


9.3.3.7 



DEFAULT DISC DEV 



Note 8 



None 



9.3.3.7 
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Table 9-1. 


GENTX Prompts (Continued) 




Discussed in 


Request 


Range 


Default 


Paragraph 


DEFAULT PRINT DEV 


Any printing device 


DUMY 


9.3.3.7 


ASSIGN LUNO 


1 -FO 


None 


9.3.3.7 


DEV NAME 


Device name 


None 


9.3.3.7 


# OF SPARE DEV LUNO BLOCKS 


0-63 


5 


9.3.3.7 


#OF SPARE FILE LUNO BLOCKS 


- 63, Note 9 


5 


9.3.3.7 


#OF FILE CONTROL BLOCKS 


- 53, Note 9 


3 


9.3.3.7 


#OF DEFAULT BUFFERS 


1 -20 





9.3.3.7 


BUFFER SIZE 


2-1024 


None 


9.3.3.7 


# OF GENERAL BUFFERS 


1 -50 





9.3.3.7 


BUFFER SIZE 


1 - 1024 


None 


9.3.3.7 


UPPER THRESHOLD - 


1 -99 


None 


9.3.3.8 


LOWER THRESHOLD - 


1 -99 


None 


9.3.3.8 



Notes: 

1, 



Any positive value that would have practical significance is accepted. The 
actual limit 1 - 65,535. 

Device names consist of one to four characters, the first of which must be 
alphabetic. 



3. These inputs apply to user-supplied DSRs for non supported devices. 

4. These inputs apply to user-supplied supervisor call routines. 

5. These inputs apply to extended operation routines. 

6. These inputs apply to tasks. 

7. Memory available for use by GENTX. 

8. Disc device name as it appeared in the name request. 

9. Not prompted if no diskettes are defined in the system. 
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Parameter 

Real Time 
Clock Cycle 

System Time Unit 



Maximum time 
period for a 
Time Slice 

Timeout Counts 



Time Delay 

Do Not Suspend 
periods. 



Table 9-2. System Timing Parameters 



Unit of Measurement 

8.3 ms. for 60 Hz. 
10 ms. for 50 Hz. 



Real Time Clock 

~j -' — 



Real Time Clock 
Cycles 



System Time Units 

System Time Units 
System Time Units 



Use 



How Specified 



Used to derive System Time Determined by power line 
Unit and to define maximum frequency, 
time period for a time slice 



Used to define Timeout 
Counts, Time Delays, and 
Do Not Suspend periods. 

Used by Scheduler. 



Used by IOS and DSR to 
detect device errors. 

Used by Scheduler. 

Used by Scheduler. 



6 cycles (50 ms.) for 60 Hz. 
4 cycles <40 ms.^ for 50 Hz. 



During system generation. 



During system generation. 



Time Delay supervisor call. 

Do Not Suspend supervisor 
call. 



The user enters the maximum number of consecutive time slices for priority level 0, followed by a 
carriage return. When a carriage return only is entered, GENTX uses the default value of 10. 
GENTX then requests a weighting factor for priority levels 1 , 2, and 3 in a similar manner. 

PL 1 WT. FACTOR- 
PL 2 WT.FACTOR- 



The next request is as follows: 

COMMON SIZE- 

The user enters the number of bytes to be allocated for the COMMON area of memory, followed by 
a carriage return. The address and size of the COMMON area is supplied to a task in response to a 
Get COMMON Data Address supervisor call. If a TXDS system is being generated, enter at least 170. 
When the user enters a carriage return only, no COMMON area is allocated in memory. 

The next request is as follows: 

# OF EXP CHASSIS - 

The user enters the number of CRU expansion chassis connected in the system, a decimal value. 
through 7, followed by a carriage return. When the user enters a carriage return only, GENTX uses 
the default value, 0. The response to this request causes GENTX to request interrupt level assign- 
ments for the expansion chassis. Chassis 1 through 4 share an interrupt level, and chassis 5 through 
7 share another interrupt level. When the response to this request is 0, explicitly or by default, the 
next two requests are omitted. 
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When the response to the number of expansion chassis is greater than 0, GENTX prints the 
following request: 

CHASSIS 1-4 INT LEVEL - 

The user specifies the interrupt level for chassis number 1 through 4, a decimal value followed by a 
carriage return. When the response to the number of expansion chassis is less than 5, the next 
request is omitted. 

When the response to the number of expansion chassis is greater than 4, GENTX prints the 
following request: 

CHASSIS 5-7 INT LEVEL - 

The user specifies the interrupt level for chassis number 5 through 7, a decimal value followed by a 
carriage return. 

9.3.3.2 Supported Peripheral Device Definitions. The peripheral devices connected to the CRU 
through the CPU chassis are defined as a group. Each device, if it conforms to the standard interrupt 
interface configuration, may be placed on the same interrupt level as another device with like 
constraints. The standard interrupt interface configuration is that CRU bit 1 5 from the base address 
of the device will be "set" when an interrupt occurs. Table 9-3 shows which supported devices may 
share an interrupt level. The user must determine if a special device conforms to this requirement. 

The peripheral devices connected to the CRU through each expansion chassis are also defined as 
a group. The devices on expansion chassis 1-4 share an interrupt level, and the devices on expansion 
chassis 5-7 share another interrupt level. Each device within an expansion chassis has a unique 
interrupt identifier for use in interrupt decoding. 

Expansion chassis interrupts may also be shared with devices connected to the CRU through the 
CPU if the devices conform to the standard interface configuration. 

The following request begins the peripheral-device definition portion of the definition phase: 

CHASSIS - 

The user enters a digit, through 7, followed by a carriage return, to specify the group of devices 
to be defined. 

A response of specifies that the subsequent device definitions (until the next chassis request) are 
those of devices connected within the CPU. A response of 1 through 7 specifies that subsequent 
device definitions are those of devices connected through expansion chassis 1 through 7, respective- 
ly. The response to this request must be consistent with the response to the number of the 
expansion-chassis request described previously. A response of a carriage return only terminates the 
device-definition portion of the definition phase. 

GENTX issues the following request to identify the first device to be defined in the chassis: 

DEV NAME - 
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The user enters a user-defined device name, consisting of up to four characters, the first of which 
must be alphabetic, the rest may be alphanumeric. The device name is followed by a carriage return. 
GENTX then requests the appropriate device information as described in the following paragraphs. 
When the user enters a carriage return only, GENTX terminates the current chassis definition, and 
repeats the "CHASSIS -" request for the next chassis. If the user wishes to correct an invalid input 
of a previously defined device, he may enter the name of that device in response to the "DEV 
NAME -" prompt and reenter all the following requests for the device type and CRU base, etc. If a 
user is defining a disc drive, then it is necessary to make the name 3 characters long. 

Following the request for a device name, GENTX issues the following request to identify the type 
of device. The type of device will determine the succeeding questions that will be asked. 

DEV TYPE 

The user enters a device-type keyword, as listed in table 9-3, followed by a carriage return. If a 
carriage return only is entered, the device definition for the above requested device name is deleted. 

Table 9-3. GENTX Device Keywords 













Default 


Multiple 


Device 




Default 


Default 


Default 


Interrupt 


Devices per 


Type 




Access 


Time-Out 


CRU 


Level 


Interrupt 


Keyword 


Device 


Mode 


Count 


Base 


(CPU Only) 


Level 


TTY 


ASR 33 Teletype 


RECORD 


8192 





6 


Yes 


ASR 


733 ASR Electronic 
Data Terminal 


RECORD 


8192 


U 


o 


1 CJ 


KSR 


733 or 743 KSR 
Electronic Data 
Terminal 


RECORD 


8192 





6 


Yes 


LP 


Line Printer 


FILE 


4096 


60 16 


6 


Yes 


FLP 


2230 or 2260 Line 
Printer 


FILE 


4096 


60 16 


6 


Yes 


CR* 


Card Reader 


FILE 


4096 


40 16 


4 


No 


V913 


913 Video Display 


RECORD 


None 


co 16 


3 


Yes 


COM 


Communications 
Device 


None 


None 


None 


None 


N/R 


FD 


Diskette Drive 


None 


None 


80 16 


7 


N/R 


V9ii 


911 Video Display 
Terminal 


RECORD 


None 


co 16 


n 
j 


Yes 


SD 


Special Device 


RECORD 


None 


None 


None 


U/D 



N/R - Not Recommended 

U/D - User decision 

* Card reader must have an exclusive interrupt assignment. 
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If the user enters one of the first eleven keywords in the table, the device is supported 
by TX990 Operating System. The last keyword, SD (special device) specifies a nonsupported device. 
Additional GENTX requests for information on nonsupported devices are described in paragraph 
"Defining Other Peripheral Devices". 

When the user enters the keyword V911 or V913 as the device type, GENTX requests the 
following: 

STATION # - 

The user enters a decimal number, 1 through 127, followed by a carriage return. The number is the 
station number used in character mode I/O to the Video Display Terminal (VDT). There is no 
default for station number. 

When the user enters the keyword ASR or TTY, GENTX prints the following requests: the name 
for the left cassette/paper-tape punch, and the right cassette/paper-tape reader: 

LEFT CASS/PTP NAME - 

RIGHT CASS/PTR NAME - 

Following each request, the user enters a user-defined device name, one to four characters, the first 
of which must be alphabetic. The device name is followed by a carriage return. The user assigns the 
cassette or paper-tape units to LUNOs by means of these device names. 

The next request for each TX990 supported device, except a communications device, is as follows: 

CRU BASE ADDR - 

The user enters the CRU base address as a hexadecimal value followed by a carriage return. A 
greater-than character (>) entered as the first character identifies the entry as hexadecimal in the 
range of numbers through 1FFE 16 . The CRU base address is the CRU address shifted one bit 
position to the left (multiplied by 2), and must be an even number. On top of each chassis is a chart 
which defines the CRU base for each device. If a carriage return is entered, a standard base will be 
used. Defaults are listed in table 9-3. 

The fourth request for each device, except diskette or a communications device, is as follows: 

ACCESS MODE - 

The user enters one of the following keywords, followed by a carriage return: 

• FILE, for a file-oriented device, or for a 913 or 91 1 VDT that is to be used in either the 
file mode or the character mode, 

• RECORD, for a record-oriented device, or for 913 or 91 1 VDT that is to be used in the 
record mode, as well as character mode (if a VDT is to be used as a system console, it 
must be in RECORD mode). 

• CHAR, for a 913 or 91 1 VDT to be used in the character mode only. 

When the user enters a carriage return only, the default access mode for the specified device applies. 
Default access mode for devices are listed in table 9-3. 
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One of the two formats is used for the fifth request, depending on whether the device is connected 
to the CRU through the CPU or through an expansion chassis. When the device is connected 
through the CPU (CHASSIS - 0), the request is as follows: 

INT LEVEL - 

The user enters a decimal or hexadecimal value followed by a carriage return. The entry represents 
the interrupt level for the device. If a carriage return only is entered, a standard level will be used. 
Defaults are listed in table 9-3. The user must not enter the interrupt level of the CLOCK. On a 
990/4 computer the clock interrupt level is 5; on a 990/10 computer the clock interrupt level is 
5 or 10. When the device is connected through an expansion chassis (chassis entry not equal to 
zero), the request is as follows: 

INT POSITION - 

The user enters a decimal value followed by a carriage return. The entry represents the interrupt 
identifier returned by the expansion chassis when a device generates an interrupt. The interrupt 
identifier is a number in the range of through 15 and is determined by connections within the 
CRU expansion chassis. 

The sixth request for each device, except a diskette or a communications device, is as follows: 

TIME-OUT COUNT - 

The user enters a decimal value followed by a carriage return. The value represents the number of 
system time units to be used as a timeout count for the device. This timeout count will be used by 
the DSR to determine how long to wait on a device before determining that a timeout error has 
occurred. When the user enters a carriage return only, the default value for the specified device 
applies. Default values for devices are listed in table 9-3. Entering a zero specifies no timeout. 

If the device is a diskette the following request is made instead of the timeout count request: 

# OF DRIVES - 

The user must enter a number in the range of one to four. 

If the user wishes to define more than one diskette drive he enters the first name and a 2, 3, 4 is 
concatenated onto the first three characters of the disc name up to the number entered for # OF 
DRIVES- prompt, thus all drives are defined from the first name entered. The names that were 
generated may not be used again, nor may they have already been used. 

If the user wants to generate a system with more than one diskette controller, he can do so by 
entering a different three-character name so that the names generated by concatenating a 2, 3, 4 
are different than the disc names that have already been defined. 

When the device is a supported device, GENTX next repeats the device name request to define 
another device. 
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9.3.3.3 Special Device Definition. Special devices are those which are not supported by TI supplied 
modules. When the device type request is printed, the user may enter the keyword SD.GENTX 
requests the same six parameters as for supported devices, then prints the following request: 

CRU INT LINE - 

The user enters a number in the range of zero through 31, followed by a carriage return. The 
number represents the displacement from the base address to the CRU line that is set when an inter- 
rupt occurs. 

The next request for a nonsupported device is as follows: 
ENTRY LABEL OF DSR - 

The user enters the entry label of the Device Service Routine (DSR) for the device followed by a 
carriage return. The entry point required in response to this request is the entry point for supervisor 
call processing. The user supplies the DSR for the device when he links the TX990 system together. 

The next request for a nonsupported device is as follows: 

ENTRY LABEL OF ROUTINE - 

The user enters the entry label of the interrupt routine for the device, usually a part of the DSR. 
followed by a carriage return. 

The next request for a nonsupported device is as follows: 

INT BRANCH LABEL - 

The user enters the label of the interrupt branch followed by a carriage return. Typically an inter- 
rupt routine performs processing common to any interrupt for the device, then branches to perform 
processing appropriate to the context of the interrupt. For example, an unsolicited interrupt usually 
requires different processing than the interrupts that occur while performing an I/O operation 
specified in a supervisor call. The label to which the unsolicited interrupt causes the system to 
branch is supplied in response to the above request. 

The next request for a nonsupported device is as follows: 

EXTENSION DATA - 

The user enters a source statement in assembly language, followed by a carriage return. The user 
may enter an exclamation point (!) following each field of the source statement to tab to the 
beginning of the next field. Specifically, entering an exclamation point positions the following 
character at position 8 . 1 3 , or 3 1 . 

The source statement will be entered in the source file for TXDATA following the source state- 
ments supplied by GENTX for the PDT for the device. GENTX repeats the request until the user 
enters a carriage return only, which terminates the definition for the device. Subsequent source 
statements are placed following the initial statement. The group of source statements entered in 
response to this series of requests forms an extension to the PDT that contains device-related data. 
When the user terminates the definition of the device, GENTX repeats the device name request to 
define another device. 
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9.3.3.4 Defining User-Supplied Supervisor Calls. When the user has terminated the 
peripheral-device portion of the definition phase, GENTX prints the following request: 

svc#- 

The user enters a hexadecimal number, followed by a carriage return. The number represents the 
call code of a user-supplied supervisor call (XOP level 15). The valid codes begin at 80i 6 and extend 
as far as required to include all user-supplied calls. For example, if three supervisor calls are supplied 
by a user, the call codes must be 80 i6 , 81 16 , and 82 16 . They may be entered in any order, but must 
all be included. Similarly, if a single supervisor call were supplied, its call code would be 80 16 . When 
the user enters a carriage return only, GENTX omits the next request and terminates the supervisor- 
call portion of the definition phase. 

When the user has entered a supervisor-call code, GENTX prints the following request: 

ENTRY LABEL - 

The user enters the entry label of the supervisor-call code, followed by a carriage return. The user 
must supply the supervisor-call routine when linking the TX990 operating system. GENTX then 
repeats the SVC number request. 

9.3.3.5 Defining Extended Operations. When the user has terminated the supervisor call portion of 
the definition phase, GENTX enters the extended operation portion of the definition phase and 
prints the following request: 

XOP#- 

The user enters a decimal number, through 14, followed by a carriage return. The number 
represents the level of a software implemented extended operation. The user supplies an XOP 
routine for the extended operation. When the user enters a carriage return only, GENTX omits the 
next two requests and terminates the extended operation portion of the definition phase. For 
further details concerning extended operation routines refer to Appendix C. 

Whpn thp> ntPr cn + oi-c on Yr»D mimkor CCMTY r^-^+o +U^ f~11~„,;~, ,-,+ . 

tth WI inv i^j^i viiivu uii /iui nuiuuvi, vjijii iyv p-i-iiiio inc ivjuvjwillg ICtjUCSU 

WORKSPACE LABEL - 

The user enters the label of the workspace of the XOP routine, followed by a carriage return. 
GENTX then prints another request: 

ENTRY LABEL - 

The user enters the label of the entry to the XOP routine, followed by a carriage return. 

The user must supply the object programs that process the XOP when linking the TX990 Operating 
System. GENTX then repeats the XOP number request. 

9.3.3.6 Defining Tasks. When the user terminates the extended operation portion, GEN IX enters 
the task definition portion. During this phase of system definition, GENTX adds to the internal 
table of data from which it will generate the source statements for TASKDF. Both system tasks, 
and user-supplied tasks must be defined at this time if they are to be linked with the new TX990 
Operating System. Table 9-4 shows the task IDs for the system tasks under the "ID" column, the 
priority level of each task is under the "PRIORITY" column, and the label on the first word of each 
task is under the "DATA LABEL" column. Each system task, and its purpose, is described in 
Appendix J. 

5TD 

Digital Systems Division 




946259-9701 



Table 9-4. System Task Definition 



Task 


ID 


Priority 


Data Label 


FMP1 


>F0 





FMP1 


FMP2 


>F1 





FMP2 


FMP3 


>F2 





FMP3 


FMP4 


>F3 





FMP4 


FUR 


>B 


1 


FUR 


VOLUME 


>c 





VOLUME 


DTASK 


>D 


1 


DIAGTS 


OCP 


>F 


1 


OCP 


CNTROL 


>16 


1 


CNTROL 


STASK 


>10 


1 


STRT 



The user may select a task ID for his tasks but they must not be the same ID as a system task ID. 
Task IDs 1-F 16 and F0 16 — FF 16 are reserved for system tasks. The task ID will be used to bid the 
task, or to execute the task from OCP. The priority level will define which tasks will use the most 
time slices. Priority level zero is the highest available priority level. The data label is a defined (using 
the assembler directive, DEF) label on the first three words of a task. These words define the initial 
Workspace, Program Counter, and End Action address. A reference (an assembler REF directive) 
will be generated inside the TASKDF module, so that the TX990 Operating System Will have the 
information needed to begin execution of that task. 

The following requests are made by GENTX asking for the above information. 
TASK ID # - 

The user enters a number, followed by a carriage return. The number represents the task identifier 
by which the task is identified to the system, and must be less than FFi 6 . Identifier 10, 6 is assigned 
to the dynamic-task area, and user tasks should be assigned identifiers greater than 10 16 . When the 
user enters a carriage return only, GENTX terminates the task-definition portion of the definition 
phase, and begins requesting information for assigning LUNOs. 

For each task, GENTX prints two requests following entry of the task identifier. The first request 
is as follows: 

PRIORITY LEVEL - 

The user enters a two-digit hexadecimal number, followed by a carriage return. The first digit must 
be one of the digits listed in table 9-5, which also lists the meaning of each digit. When the digit that 
applies to the task is zero, it may be omitted. The second digit is the actual priority level. Priority 
level should be used only for system tasks. 

The second request is as follows: 

INITIAL DATA LABEL - 

The user enters the label on the first word in the task, followed by a carriage return. Then GENTX 
repeats the task ID request. When all tasks have been defined and the user has terminated the 
task-definition portion, GENTX asks if the system is to support multiple dynamic tasks. 
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Table 9-5. Priority Digits 

Digit 
(Hexadecimal) Meaning 

Privileged ; not active at initial load of operating 
system, restart, or power restart. 

1 Privileged; active at initial load of operating 
system or restart; not active at power restart. 

2 Privileged; not active at initial load of operating 
system or restart; active at power restart. 

3 Privileged; active at initial load of operating 
system, restart, or power restart. 

The request is as follows: 

MULTIPLE DYNAMIC TASKS (Y OR N) - 

The user should enter Y or N. If the response is N, GENTX proceeds to the Assign LUNO phase. If 
the response is Y, GENTX requests the maximum number of dynamic tasks allowed to be in the 
dynamic task area at one time, as follows: 

# OF DYNAMIC TASKS - 

The user enters a decimal number between 1 and 255, inclusive. Then GENTX requests the 
maximum number of procedures allowed to be installed in the dynamic task area at one time, as 
follows: 

# OF PROCEDURES - 

ine user enters a uecimai nuniuci uciwccn u aim i^/, caliumvc. \jij,i>iiyv men piuw;cus iu me 
Assign LUNO phase. 

9.3.3.7 Information For Assigning LUNOs. The following information is used to.generate: names 
for LUNO assignments; memory blocks that will be reserved for device LUNOs; and file LUNOs and 
memory blocks that will be reserved for communication devices. 

The following request is made by GENTX asking for the device name of the system console. Most 
of the utilities, and the Operator Communication Package (OCP) interact with the user through the 
system console. The request is as follows: 

CONSOLE DEV NAME - 

The user enters the device name (previously assigned) for the system console, followed by a carriage 
return. The device must be either device type ASR, KSR, or VDT. When the device is device type 
VDT, it must have been previously defined for the record mode. The user may enter a carriage 
return only to specify no system console. 
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GENTX makes the following request: 
DEFAULT DISC DEV - 

The user must enter the diskette device name (previously defined) as it appeared in the name 
request. The user may enter a carriage return to specify no default disc. The default disc name is 
used when a utility is referring to the system disc; it is also used when no disc name is appended to 
the pathname of a file. 

GENTX makes the following request: 

DEFAULT PRINT DEV - 

The user enters the device name (previously defined) for the system default printers. The device can 
be any printing device. The user may enter a carriage return to specify the Dumy device. The 
device is used by some of the Tl-supplied utilities when no listing device is specified. It is a required 
parameter in a TX990 Operating System that supports a Terminal Executive Development System. 

Next, GENTX prints the following request: 

ASSIGN LUNO - 

The user enters a hexadecimal value, followed by a carriage return. The range of values is 1 through 
F0 16 . The value represents a LUNO by which a device is accessed for I/O operations. When the user 
enters a carriage return only, GENTX skips the next request of the definition phase. Otherwise, 
GENTX requests the name of the device to be assigned to the LUNO, as follows: 

DEV NAME - 

The user enters the device name previously assigned to a device. GENTX then repeats the assign 
LUNO request. 

The next request is as follows: 

# OF SPARE DEV LUNO BLOCKS - 

The user enters a decimal number followed by a carriage return. The number represents the number 
of device logical unit blocks to be provided in the system in addition to those numbers assigned 
previously. When the ALUNO OCP command of the File Utility supervisor call is included in a 
TX990 system, there must be logical unit blocks for all LUNOs that will be assigned at one time. 
When the user enters a carriage return only in response to the request, GENTX provides five 
additional blocks. In systems which support multiple dynamic tasks, more blocks may be necessary. 

The next request, if a diskette has been defined, is as follows: 

# OF SPARE FILE LUNO BLOCKS - 

The user enters a decimal number followed by a carriage return. The number represents the number 
of file logical unit blocks to be provided in the system. There must be file logical unit blocks for all 
LUNOs that will be assigned to files at one time. When the user enters a carriage return, GENTX 
provides five additional blocks. 
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The next request, if a diskette has been defined, is as follows: 

# OF FILE CONTROL BLOCKS - 

The user enters a number between and 50. The number represents the maximum number of files 
that can be open at any time. If File Management is to be used with TXDS, a minimum of three File 
Control Blocks are required. 

The next request is as follows: 

# OF DEFAULT BUFFERS - 

The user enters a decimal number from to 20. If a carriage return is entered, no buffers are 
reserved and GENTX skips the size request. If GENTX accepts the number, it requests the size of 
the buffer in bytes by presenting the following prompt: 

BUFFER SIZE - 

The user must enter a decimal number from two to 1024. 
The next request is: 

# OF GENERAL BUFFERS - 

The user enters a decimal number from to 50. If a carriage return is entered, no buffers are 
allocated and GENTX omits the next request and terminates the general buffer portion of the 
definition phase. 

If GENTX accepts the number it requests: 

BUFFER SIZE - 

The user enters a decimal number from 1 to 1024 which represents the number of bytes in each 
buffer. GENTX then repeats the GENERAL BUFFER request- The default and general buffers are 
simply reserved areas in the system table area which may be accessed by user tasks via the Get Data 
and Put Data SVCs. 

9.3.3.8 Communication Threshold Definition. If a device name was defined as a communications 
device by entering "COM" for the "DEV TYPE-" request, GENTX requests the communications 
thresholds as follows: 

UPPER THRESHOLD - 

LOWER THRESHOLD - 

(The user is referred to the Communications Systems Manual for a detailed explanation of 
thresholds.) The user enters decimal numbers, from 1 to 99, and the upper threshold must be 
greater than or equal to the lower. If in error, the sequence will be repeated. 
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9.3.3.9 Suggestions For Defining Devices. The following request of GENTX are repeated until the 
user enters a carriage return only in response. This allows an indefinite number of each item to be 
defined, as appropriate for the application. These requests are as follows: 

CHASSIS 

svc# 

XOP# 

TASK ID# 

ASSIGN LUNO 

# OF GENERAL BUFFERS 

When the same chassis number is entered by the user in response to a subsequent chassis request, 
additional devices entered following the second entry of the chassis number are added to the group 
originally defined. This allows definition of devices by function or by physical arrangement rather 
than by connection within the computer. That is, in the following example, the line printer and 
card reader are connected through the CPU, and the VDT is connected through expansion chassis 1 : 



CHASSIS - 




DEV NAME 


-LIPR 


DEV TYPE - 


LP 



DEV NAME - 

CHASSIS - 1 

DEV NAME - GTTY 
DEV TYPE - V913 



DEV NAME - 
CHASSIS - 

DEV NAME - CRDR 
DEV TYPE - CR 

When the same device name, supervisor call number, extended operation number, task identifier, 
or LUNO is entered again, the previously entered information is replaced by the new information, 
redefining the item. To delete a device name, enter the chassis number and the device name. Then 
enter a carriage return only in response to the device type request. 
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9.3.4 CONSTRUCTION PHASE. After the last request of the Definition Phase of GENTX, the 

Construction Phase is entered. During the construction phase, GENTX generates source statements 
for TXDATA and TASKDF using the responses entered by the user during the definition phase. 
GENTX prints the following request: 

TASKDF OUTPUT FILE NAME - 

The user may enter the full file name or device name. If the file does not exist it will be created. 

The user may inhibit output of TASKDF by entering a carriage return only. GENTX then prints the 
final request as follows: 

TXDATA OUTPUT FILE NAME - 

The user enters the full file or device name. When the file does not exist it will be created. The 
user may inhibit output of TXDATA by entering a carriage return only. GENTX then terminates, 
bidding the rebid task. 

NOTE 

DX10 output file names must be full pathnames; synonyms are 
not accepted. 

9.3.5 GENTX ERROR MESSAGES. Table 9-6 lists the error messages or warnings produced by 
GENTX. 

Table 9-6. GENTX Error Messages 



Error 

* INVALID INPUT* 

* INPUT ERROR* 

*i*TTT TIDT V TMTCTMCn 

• iVIU L, 1 11 L-, i ISl-ii.- LL-M-iLS 

INPUT* 

*LUNO ASSIGNED 
TO CONSOLE* 

* INVALID DEV* 
*ASSIGN ERROR* 



Reason 

Response not valid. 
Response not within range. 

TV.o innnt hut slrMrlv heen nre- 

viously defined. 

User tried to assign LUNO to a 
device other than the console. 



Recovery 

Reenter response. 
Reenter response. 
Reenter response. 



Select a LUNO other than 0. 
Reenter response. 



The device type name was not valid See table 7-3. Reenter response. 



Could not assign* LUNO 1 to the 
output device or file. 



Release some LUNOs and re- 
execute the task; or an invalid 
device name was entered. Re- 
enter response. 



*OPEN ERROR* 



*CLOSE ERROR* 



*STORAGE ALLOC. 
ERROR* 



Could not open output device or 
file. 

Could not close, or release output 
device of file. 

GENTX table area exhausted. Mem- 
ory area not large enough. 



Reexecute task and increase 
size of the MEMORY 
AVAILABLE request. 
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9.4 ASSEMBLING THE SOURCE MODULES 

After termination of GENTX, the user must assemble the two source modules, TXDATA and 
TASKDF. Assembly is accomplished by executing the TXDS Assembler, TXMIRA. Each source 
module is assembled separately. 

For detailed instructions for operating TXMIRA consult the TXDS Programmer's Guide. 

9.5 LINKING THE OBJECT MODULES 

After assembling the two modules it is necessary to use the Object Manager to select the Tl-supplied 
object modules that support features of the TX990 operating system. Selection of these features is 
made from the object module files residing on the diskette which contains the TX990 parts and an 
object file residing on the system diskette. The files are described below: 

:DSRLIB/OBJ - Object file that contains DSR modules supplied by Texas Instruments; 

:DYNTSK/OBJ - Object file that contains modules to support multiple dynamic tasks; 

:OCPLIB/OBJ - Object file that contains OCP modules supplied by Texas Instruments; 

:FMPLIB/OBJ - Object file that contains FILE MANAGEMENT modules supplied by 
Texas Instruments; 

:CNTROL/OBJ - Object file that contains the TXDS control program; 

:TXLIB/OBJ - Object file that contains TX990 modules supplied by Texas Instruments. 

The user must create a file that will contain all the object modules he wishes to link to form the 
new operating system. This new file will contain modules from each of the object library files. The 
user should refer to table 9-7 to select the modules which support the desired features. The modules 
should be selected from the files in the following order: 

:DSRLIB/OBJ 

•.DYNTSK/OBJ 

:OCPLIB/OBJ 

:FMPLIB/OBJ 

:CNTROL/OBJ 

:TXLIB/OBJ 
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Table 9-7. TX990 Operating System Modules 



Name 


Function 


Ap proximate 
Size (Bytes) 


Required 


Required 
for OCP 


Required for 

File 
Management 


List In 
TASKDF 


TXDATA 


System configuration in- 
formation, interrupt de- 
coders, trap initialization 
data. 


Typical 
600-1200 


X 








TASKDF 


Task Definition module. 
All tasks must be identi- 


Typical 
100-200 


X 









fied here. 



Notes 




O 



DSRLIB 



FPYDSR FD800 Diskette support 1066 



X 



TXDATA must contain Device 
Name Table (DNT)** and Phys- 
ical Device Table (PDT)** 
entries for diskettes. 



! FLPDSR Models 2230 and 2260 
Line Printer Support 



272 



TXDATA must contain DNT** 
and PDT** entries for Line 
Printers. 



DSR733 733 ASR Keyboard/ 1460 

Printer and Cassette 
Unit support 

DSR9 1 3 913 VDT support for 700 

record or file mode I/O 



DSR9 1 1 911 VDT support as a 730 

sequential I/O device 



* One of the DSRs with an asterisk must be included for OCP. 

** DNTs and PDTs are placed in TXDATA by using the GENTX utility. 

*** 1'LPDSR and LPDSR must not be included in the system together. 



TXDATA must contain DNT** 
and PDT** entries for 733 ASRs. 



TXDATA must contain DNT** 
and PDT** entries for VDTs. Sys- 
tem must include STA913, unless 
only character mode I/O is used. 

TXDATA must include DNT** 
and PDT** entries for VDTs. 
System must include STA911. 



Table 9-7. TX990 Operating System Modules (Continued) 




Name Function 

***LPDSR Models 306, 588, and 810 

Line Printer support 



Approximate 
Size (Bytes) 

264 



Required 





Required for 




Required 


File 


List In 


for OCP 


Management 


TASKDF 



Notes 

TXDATA must contain DNT** 
and PDT** entries for Line 
Printers. 



CRDSR Card Reader support 



508 



TXDATA must contain DNT** 
and PDT** entries for Card 
Readers. 



i 

to 



KSRDSR 733 or 743 KSR Key- 700 

board/Printer support 

DSRTTY ASR33 Teletype support 1460 



DSR5MT 5MT/6MT special device 532 

support 

DIGDSR 32-IN Transition Detection 177 

Module Special device 
support 



TXDATA must contain DNT** 
and PDT** entries for 733 KSRs. 

TXDATA must contain DNT** 
and PDT** entries for ASRs. 

DSR module to control the 
5MT/6MT I/O Interface. 

DSR module to control the 
32-IN Transition Detection 
module. 



OCPLIB 



OCPTSK OCP data base 



D 
to 

CD 

3 

CO 

O 
5" 
5' 
o" 

3 



OCPTBL 



OCP configuration 
tables 



250 



180 



X 



X 



X System must include TSKFUN, 

IOSUPR, CNVRSN, FURSVC, 
OCPTBL, OCPPRC, and OCPEND. 

System must include TSKFUN 
IOSUPR, CNVRSN, FURSVC, 
OCPTSK, OCPPRC, and OCPEND. 



* One of the DSRs with an asterisk must be included for OCP. 

** DNTs and PDTs are placed in TXDATA by using the GENTX utility. 

*** FLPDSR and LPDSR must not be included in the system together. 



1 



0) 

*<: 

CO 

■-*. 
CD 

3 
co 

D 
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5' 
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Table 9-7. TX990 Operating System Modules (Continued) 
Approximate 



Name Function 

OCPPRC OCP main procedure 



OCPIOU ST ASK, SIO, REWIND, 

FSPACE, and BSPACE 
OCP commands 



Size (Bytes) 

600 

600 



Required 



Required 
for OCP 

X 



Required for 

File 
Management 



List In 
TASKDF 



DOCPIOU SPROC, STASK, SIO, 790 

REWIND, FSPACE, 
and BSPACE OCP 

commands 

OCPTLD DWKSP, KTASK, and 330 

KIO OCP commands 



OCPSLD LMEM,DMEM,SBKPT, 550 

CBKPT, ADD, SUB, and 
JMP OCP commands 



OCPTAD TIME and IDATE OCP 

commands 



520 




Notes 

System must include TSKFUN, 
IOSUPR, CNVRSN, FURSVC, 
OCPTSK, OCPTBL, and OCPEND. 

System must include TSKFUN, 
IOSUPR, CNVRSN, FURSVC, 
OCPTSK, OCPTBL, OCPPRC, 
and OCPEND. 

This module must be used in 
place of OCPIOU if multiple 
dynamic tasks are allowed; it 
isin:DYNTSK/OBJ. 

System must include TSKFUN, 
IOSUPR, CNVRSN, FURSVC, 
OCPTSK, OCPTBL, OCPPRC, 
OCPSLD, and OCPEND. 

System must include TSKFUN, 
IOSUPR, CNVRSN, FURSVC, 
OCPTSK, OCPTBL, OCPPRC, 
and OCPEND. 

System must include TSKFUN, 
IOSUPR, CNVRSN, FURSVC , 
OCPTSK, OCPTBL, OCPPRC, 
and OCPEND. 



*>. 
to 

I 

-J 

o 



Table 9-7. TX990 Operating System Modules (Continued) 




4*. 



Name Function 



OCPLRT ALUNO, RLUNO, LPROG, 420 

and EXECUTE OCP com- 
mands 



DOCPLRT AL, RL, LP, EX, IT, DT, 700 

IP, DP, OCP commands 









Required for 




Approximate 




Required 


File 


List In 


Size (Bytes) 


Required 


for OCP 


Management 


TASKDF 



OCPEND OCP dummy external 

reference/definition 
module 



20 



Notes 

System must include TSKFUN, 
IOSUPR, CNVRSN, FURSVC, 
OCPTSK, OCPTBL, OCPPRC, 
OCPEND, and TSKLDR. 

Must be included to support 
multiple dynamic tasks. This 
module is in :DYNTSK/OBJ. 

System must include TSKFUN, 
IOSUPR, CNVRSN, FURSVC, 
OCPTSK, OCPTBL, and OCPPRC. 



CONTROL 



CONTROL TXDS control program 



1340 



X 



FMPLIB 



TXFMP1 File management data 

section for drive 1 



100 



X 



X 



D 

<Q 
0) 
CO 

■"■» 
CO 

3 

CO 

5" 
5" 
o" 

3 



TXFMP2 File management data 100 

section for drive 2 

TXFMP3 File management data 100 

section for drive 3 

TXFMP4 File management data 100 

section for drive 4 

t Required only if the corresponding drive is included in the system. 



xt 


Xf 


xt 


xt 


Xf 


xt 



Name 


Function 


Approximate 
Size (Bytes) 


TXFMP 


File Management main 
drive and opcode decoder 


266 


FMOPEN 


Open processor for files 


500 


FMCLOS 


Close processor for files 


336 


FMREAD 


Read processor for files 


520 


FMWRIT 


Write processor for files 


560 


FMFBSP 


Forward and backspace 
processors for files 


420 


FMUTIL 


Utility routines to support 
the other file management 
opcode processors 


500 



Table 9-7. TX990 Operating System Modules (Continued) 



Required 





Required for 




Required 


File 


List In 


for OCP 


Management 


TASKDF 



FURTSK File utility opcode decode 124 

for opcodes 90i 6 to 99 J6 

FURSVC Contains assign and release 700 

LUNOs for files and devices 
including those for super- 
visor call 15 1 6 



X 

X 
X 
X 
X 

X 



X 



Notes 



X 




If only assign and release LUNO 
support is required the user may 
include only this module with- 
out the rest of File Management. 
The system must include 
IOSUPR and TSKFUN. 



O 

■ 
O 



Table 9-7. TX990 Operating System Modules (Continued) 




Name 


Function 


Approximate 
Size (Bytes) 


iRDIR 


Searches the file directory 
for a particular file 


154 


LUNIT 


Allocates AUs on the 
diskette, also deallocates 
AUs on the diskette 


292 



Required 





Required for 




Required 


File 


List In 


for OCP 


Management 


TASKDF 



Notes 



X 



X 



to 

o 



FILESV Contains the create, delete, 

and compress modules for 
file utility 



278 



X 



SO 
■ 
to 

ON 



CHSVC Contains the change protec- 

tion, and change name 
modules for file utility 



276 



TXLIB 



to 
Co 

"5 

CD 

3 
CO 

D 
5" 
5" 
o" 

3 



TXROOT Scheduler, clock handler, 1000 

internal interrupt processors, 
interrupt and XOP return 
processing, queueing 
routines, time delay 
management, date/time 
control, error handling, 
bid task logic. 

SVC9 13 913 VDT Utility supervisor 430 

call routine 

STA913 913 VDT character mode 204 

input support 



X 



TXDATA must contain Key- 
board Status Block (KSB) 
entries for VDTs. 



Table 9-7. TX990 Operating System Modules (Continued) 




Name Function 

SVC91 1 911 VDT Utility supervisor 430 

cull 

STA9 11 911 VDT character mode 204 

input support 



CRTPRO Decodes the VDT 913, or 164 

VDT 91 1 supervisor call 



IOSUPR Input/Output supervisor 900 

call routine 









Required for 




Approximate 




Required 


File 


List In 


Size (Bytes) 


Required 


for OCP 


Management 


TASKDF 



X 



X 



Notes 



TXDATA must contain the Key- 
board Status Block (KSB) 
entries for VDTs. 

Must be present if STA91 1 , 
SVC91 1, STA913, or SVC913 
modules are included 

System must include TSKFUN. 



so 

ON 

tsi 

■ 
-J 

o 



MEMSVC Get/Return Memory and 
Set Condition 



56 



DMEMSVC Same as MEMSVC 176 

TBUFMG Buffer management routine 176 



X 



Supports multiple dynamic tasks. 
This module is in :DYNTSK/OBJ. 



CNVRSN 


Hexadecimal/decimal/binary 


360 




conversion supervisor call 






routines 




EVENTK 


Break key 


250 


TSKLDR 


Object module loader 


462 



X 



X 



Used in AMPL systems. 

System must include TSKFUN 
and IOSUPR. 



NO 

00 



D 

<5' 
«■■* 
to 

CO 

«■» 

CD 

3 

Co 

D 
5" 

5" 
5" 

3 



Table 9-7. TX990 Operating System Modules (Continued) 



Name Function 

DTSKLDR Object module loader 



Approximate 
Size (Bytes) 

520 



Required 





Required for 




Required 


File 


List In 


for OCP 


Management 


TASKDF 



IMGLDR Program image loader 478 

DYNTSK Multiple dynamic task 780 

support 

TSKFUN Task support function: 290 

Bid Task, Get Parameters, 
End of Task, Do Not Su- 
spend, Time Delay, Change 
Priority, Unconditional 
Wait, Activate Suspended 
Task, Date and Time, and 
Get Common Address 
supervisor call routines 

TITTCM GETDAT/PUTDAT 140 

Supervisor calls routine 

DTASK Diagnostic task 242 



TXSTRT Initial and manual restart 200 

logic 



X 



X 




Notes 

Supports multiple dynamic tasks. 
This module is in :DYNTSK/OBJ. 

Loads images from program files. 

This module is in :DYNTSK/OBJ. 



System must include TSKFUN 
and IOSUPR. 

May optionally be placed follow- 
ing module TXEND to provide 
more memory for dynamic task 
area. When TXSTRT is placed 
following TXEND, TXSTRT 
executes only on IPL, and 
manual restart is not possible. 



Table 9-7. TX990 Operating System Modules (Continued) 




Name Function 

TXEND TX990 dummy external 

reference/definition 
module 



Approximate 
Size (Bytes) 

12 



Required 
X 



Required 
for OCP 



Required for 

File 
Management 



List In 
TASKDF 



Notes 



4» 
OS 
to 
Ul 

vo 

I 

-J 

o 



ST ASK 



Initial startup task 



180 



to 



May optionally be placed 
between TXSTRT and TXEND 
to be executed both during an 
IPL and during a manual restart. 
ST ASK begins execution at the 
completion of each IPL to iden- 
tify the revision level of the 
operating system and to indicate 
that the IPL has executed suc- 
cessfully. When ST ASK is linked 
following TXEND, it is located in 
the dynamic task area, where it 
will be overlaid by the first user 
task installed in the dynamic 
task area. It is assigned task 
identifier 10i 6 . When it is 
desired to execute STASK follow- 
ing a manual restart, STASK 
must be linked ahead of TXEND. 



*§! 
«■■♦." 
to 

CO 

•■■* 

CD 

3 

CO 

5" 
5* 
S" 

3 
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There is no defined order in which modules must be included, although user-supplied object 
modules and programs must be included before the object module TXEND, in file: TXLIB/OBJ. It 
is logical to place a DSR with the other DSRs, a supervisor call routine with the supervisor call 
routines, and a task with the other tasks. 

After the file has been generated by the Object Manager (OBJMGR), the user must link it with the 
two object modules, TXDATA and TASKDF. TXDATA must be first in the link sequence and 
TASKDF must be second. 

Because many modules which may be incorporated in a customized TX990 system are optional, the 
modules TXEND and OCPEND contain many dummy symbol definitions. When optional modules 
are included, the link editing process results in multiply defined symbol errors, as shown in the 
following: 

SYMBOL MULTIPLY DEFINED *W*W*W*W*W*W*W*W*W*W*W*W*W*W*W* 
SYMBOL = ALRSET , MODULES = 47, 49 

SYMBOL MULTIPLY DEFINED *W*W*W*W*W*W*W*W*W*W*W*W*W**W*W* 
SYMBOL = BADID MODULES = 42, 49 

Such errors do not result in an incorrect link edit. To be sure that the multiply defined symbols are 
not caused by fatal errors, compare the second number given after MODULES in the error message 
to the module numbers given in the link map for: OCPLRT, OCPIOU, OCPEND, or TXEND. 

The following is an example of part of such a link map: 



OCPTAD 


48 


657A 


01F8 


INCLUDE 


01/14/77 


14:07:24 


SDSMAC 


OCPEND 


49 


6772 


0016 


INCLUDE 


09/15/77 


11:26:28 


SDSMAC 


TXEND 


50 


6788 


0142 


INCLUDE 


10/05/77 


13:15:42 


SDSMAC 



If the numbers match, the error is nonfatal and is to be expected. 

After the files have been linked to form a new TX990 operating system, the new object module file 
containing the new TX990 must be defined as the system file by using the System Utility 
(SYSUTL) command "SF". Also, the TXBOOT program must be copied to the diskette by using 
the SYSUTL command "BC". 

9.6 EXAMPLE OF SYSTEM GENERATION 

The materials needed are: 

• The TX990 parts diskette (diskette # 1 ) 

• The TXDS system diskette (one of TXDS system diskettes #2,3,6) 

• A scratch disc on which the system can be built. 
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NOTE 

Operat^ responses to prompts presented on the system console are 
underlined in the following procedure. Prompts are not underlined. 

1. Load diskette #1 (TXPARTS) in diskette drive 2 (right). Load diskette #2, #3, or 
#6 (TXDS system) in diskette drive 1 (left). 

2. Load the TX990 Operating System into memory by pressing the following keys on the 
Programmer's Panel. 

a. Halt 

b. Reset 

c. Load 

After the TX990 Operating System is loaded into memory the following message will be 
printed out or displayed on the system console: 

TX990 SYSTEM Release 2.2 

MEMORY SIZE (WORDS): 24576 MEMORY AVAILABLE: 16749 

3. Bid TXDS by entering an exclamation point (!) on the terminal. The following display 

\ifi11 onnpor nn +1i£» c ^'St p *m C^nSOl* 3 : 
| 

TXDS 936215 ** 1/0 0: 
PROGRAM: 

4. Load a scratch diskette in drive # 1 . 

5. Initialize the scratch diskette by responding to the prompts printed out or displayed on 
the system console as follows: 

TXDS 936215 ** 1/0 0:02 

PROGRAM : : BACKUP/SYS * 

BACKUP AND INITIALIZE UTILITY 936212 *A 

OUTPUT DISC OR VOLUME NAME? DSC 
THE OUTPUT DISC MUST BE INITIALIZED 
INITIALIZE DSC ?(Y/N) Y 
DISC I. D. ? SCRATCH 
VOLUME NAME ? SCR 

CHECKING DSC 
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6. 



Take 
Take 
Take 
Take 
Take 
Take 



default 
default 
default 
default 
default 
default 



(table 7-7) 
(table 7-7) 
(table 7-7) 
(table 7-7) 
(table 7-7) 
(table 7-7) 



After the diskette has been initialized, the user must bid the System Generation 
(GENTX) Utility by responding to the prompts printed out or displayed on the system 
console as presented below. When no response to a prompt is indicated, the user must 
enter a carriage return/NEW LINE to cause the default-substitute to be used. 

TXDS 936215 ** 1/ 0:12 

PROGRAM: :GENTX/SYS* 

TX990 SYSTEM GENERATION 945673 *B 

MEMORY AVAILABLE - 2000 

LINE FREQ. - 
TIME SLICE - 
PL WT. FACTOR - 
PL 1 WT. FACTOR - 
PL 2 WT. FACTOR - 
PL 3 WT. FACTOR - 
COMMON SIZE - 170 
# OF EXP CHASSIS - 
CHASSIS -0 

a. For ASR System 

DEV NAME - LOG 

DEV TYPE - ASR 

LEFT CASS/PTP NAME - CS1_ 

RIGHT CASS/PTR NAME - CS2 

CRU BASE ADDR - 

ACCESS MODE - 

INT LEVEL - 

TIME-OUT COUNT - 

b. For 911 System: 

DEV NAME - LOG 
STATION # - I 
CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 
TIME-OUT COUNT - 

c. For 913 System: 

DEV NAME - LOG 
STATION # - I 
CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 
TIME-OUT COUNT - 



Take default (table 7-3) 
Take default (table 7-3) 
Take default (table 7-3) 
Take default (table 7-3) 



Take default (table 7-3) 
Take default (table 7-3) 
Take default (table 7-3) 
Take default (table 7-3) 



Take default (table 7-3) 
Take default (table 7-3) 
Take default (table 7-3) 
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Resume system generation : 

DEV NAME - DSC 
DEV TYPE - FD 
CRU BASE ADDR - 
INT LEVEL - 
# OF DRIVES - 2 



Generate floppy 

Take default (table 7-3) 
Take default (table 7-3) 
Two drives: DSC and DSC2 



DEV NAME -LP 
DEV TYPE -LP 
CRU BASE ADDR - 
ACCESS MODE - 
INT LEVEL - 

TIME-OUT COUNT - 



Take default (table 7-3) 
Take default (table 7-3) 
6 on 9 1 1 system or 
take default (table 7-3) 
Take default (table 7-3) 



DEV NAME - 
CHASSIS - 

svc#- 

XOP#- 

TASK ID # - >F0 

PRIORITY LEVEL -0. 

INITIAL DATA LABEL - FMP1 
TASKID#->F1 

PRIORITY LEVEL -0 

INITIAL DATA LABEL - FMP2 
TASK ID # - >B 

PRIORITY LEVEL - 1 

INITIAL DATA LABEL - FUR 
TASKID#->C 
PRIORITY LEVEL - 
INITIAL DATA LABEL - VOLUME 
TASK ID # - >D 

PRIORITY LEVEL -J. 

INITIAL DATA LABEL - DIAGTS 
TASK ID # - >F 

PRIORITY LEVEL -1 

INITIAL DATA LABEL - OCP 
TASKID#->16 

PRIORITY LEVEL - j_ 

INITIAL DATA LABEL - CNTROL 
TASK ID # - 

MULTIPLE DYNAMIC TASKS 
(Y OR N) - N 
CONSOLE DEV NAME - LOG 
DEFAULT DISC DEV - DSC 
DEFAULT PRINT DEV - LP 
ASSIGN LUNO -J_ 

DEV NAME - LOG 
ASSIGN LUNO - 

# OF SPARE DEV LUNO BLKS - 

# OF SPARE FILE LUNO BLKS - 



Terminate sequence 



FMP1 



FMP2 



FUR 



Volume name support 



t-\: ±1 „ T„„\ r 



Add in OCP 



TXDS CONTROL 



Terminate sequence 



Terminate sequence 
Take default (table 7-3) 
Take default (table 7-3) 
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# OF FILE CONTROL BLOCKS - 3 

# OF DEFAULT BUFFERS - None 

# OF GENERAL BUFFERS - 

# OF GENERAL BUFFERS - Terminate sequence 
TASKDF OUTPUT FILE NAME - :TASKDF/SRC Note 1 
TXDATA OUTPUT FILE NAME - :TXDATA/SRC Note 2 



END TX990 SYSGEN 



7. 



Select the Tl-supplied object modules to support the desired TX990 Operating System 
features and copy them to the scratch diskette by responding to the prompts as follows: 

TXDS 936215 *A 1/0 00:00 

PROGRAM: :OBJMGR/* 

990 OBJECT MANAGER 939870 ** 

OUTPUT FILE: DSCTXPART/OBJ 
INPUT FILE: DSC2:DSRLIB/OBJ 

REWIND INPUT FILE? Y 
FPYDSR ? C 

DSR733 ? C SifnoASR733 

KSRDSR ? S 
LPDSR ? C 
FLPDSR ? S 

DSR913 ? S Cif913VDT 

CRDSR ? S 
DSRTTY ? S 

DSR911 ? S Cif911VDT 

DSR5MT ? S 
DIGDSR ? S 
END-OF-FILE 

Notes: 

1 . Constructs a source program for the task definitions and puts them in the file :TASKDF/SRC. 

2. Constructs a source program for the TX990 Operating System data structures and puts them in 
the file :TXDATA/SRC. 
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INPUT FILE: DSC2:OCPLIB/OBJ 
REWIND INPUT FILE? Y 
OCPTSK ? A 
END-OF-FILE 



INPUT FILE: DSC2:FMPLIB/OBJ 


REWIND INPUT FILE? Y 


VOLUME 


? C 


TXFMP1 


? C 


TXFMP2 




TXFMP3 


? s 


TXFMP4 


? s 


TXFMP 


? c 


FMOPEN 


? A 


END-OF-FILE 



All of OCP is included, 
without multiple dy- 
namic task support 



No DSC3 
No DSC4 
Rest of file 



INPUT FILE: DSC2:CONTROL/OBJ 

REWIND INPUT FILE? Y 
CNTROL ? C 
END-OF-FILE 



INPUT FILE: DSC2:TXLIB/OBJ 
REWIND INPUT FILE? Y 



TXROOT 


? 


C 


IMGLDR 


7 


C 


EVENTK 


? 


s 


TITTCM 


? 


c 


CRTPRO 


? 


c 


STA913 


? 


c 


SVC913 


? 


c 


STA911 


? 


s 


SVC911 


? 


s 


IOSUPR 


7 


c 


TSKFUN 


? 


c 


TSKLDR 


? 


c 


CNVRSN 


? 


c 


MEMSVC 


9 


c 


TBUFMG 


? 


c 


DTASK 


o 


c 


TXSTRT 


? 


c 


TXEND 


7 


c 


STASK 


7 


c 


END-OF-FILE 




INPUT FILE: * 


FND OBJECT MANAGER 



S if no 913 VDT 
S if no 913 VDT 
C if 911 VDT 
C if 911 VDT 
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10. 



8. Remove diskette #1 from drive #2 and load diskette #2 or #3 or #6 in drive #2. 

9- Assemble TASKDF and TXDATA for linking with the selected Tl-supplied modules as 
follows: 



TXDS 936215 ** 1/ 0:40 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



TXMIRA/SYS 



TXDATA/SRC 



CLS 
TXMIRA 936227 ** 

TXDS 936215 ** 1/ 0:46 

: TXMIRA/SYS 



TXDATA/OBJ,:TXDATA/LST 



Assemble TXDATA 
Put listing on diskette 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



TASKDF/SRC 



TASKDF/OBJ,:TASKDF/LST 



CLS 



Assemble TXDF 
Put listing on diskette 



TXMIRA 936227 ** 
Link the system as follows: 
TXDS 936215 ** 



1/ 0:47 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



TXLINK/SYS 



TXDATA/OBJ. :TASKDF/OBJ,:TXPART/ORT 



CLITX990 
TXLINK 937537 ** 



NEWSYS/SYS,:NEWSYS/LST 



1 1 • Remove diskette #2 or #3 or #6 from drive #2 and load diskette #1 in drive #2. 
1 2. Mark the newly-linked system as the system file as follows: 

TXDS 936215 ** 1/ 0: 54 

PROGRAM: :SYSUTL/SYS* 

TX990 SYSTEMS UTILITY 937544 ** 

OP: .SF, :NEWSYS/SYS. TE. 
0:55:35 JAN 1, 

TXDS 936215 ** 1/ 0: 55 

PROGRAM: 
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13. Load into memory the new TX990 Operating System by pressing the HALT, RESET, 
and LOAD keys on the Programmer Panel: 

TX990 SYSTEM RELEASE 2.2 

MEMORY SIZE (WORDS): 24576 AVAILABLE: 14631 

14. Bid TXDS via OCP by entering an exclamation point (!) to bid OCP; then respond to the 
period (.) prompt as follows: 



■ EX, 16. TE. (Execute TXDS) 

TXDS 936215 ** 1/ 0: 

15. Remove diskette #1 from diskette drive #2 and insert diskette #2 into drive #2. 

1 6. Copy TXDATA, TASKDF and LINK MAP LISTINGS to LP as follows: 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



:TXCCAT/SYS 

:TXDATA/LST,:TASKDF/LST,:NEWSYS/LST 

LP 

RO 



TXCCAT 937543 ** 
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SECTION X 
DISKETTE/DISC BACKUP AND INITIALIZE PROGRAM 

10.1 INTRODUCTION 

The Diskette Backup and Initialize Utility Program (BACKUP) may be used for two functions: 
initializing a diskette and copying (backing up) files to a diskette. It allows the user to: back up an 
entire diskette, partially backup a diskette, simply initialize a new diskette, or partially backup 
several diskettes to a single diskette. 

The backup utility can copy and verify files, or copy or verify files separately. Errors are listed at 
the system console. Files that have no data are identified by warning messages. 

Before writing to the output diskette, BACKUP checks to see if it is initialized. If not, it requests 
the user to initialize the diskette, prompting for required information. When copying files, BACKUP 
generates contiguous files on the output diskette, thus reducing fragmentation of disk space. 

BACKUP also initialize the directory and allocation bit map on the output diskette, and can 
designate a system file if requested by the user. 

10.2 LUNOs AND THEIR USES 

LUNOs 5, 6, 10 and 11 are used. All LUNOs are assigned by BACKUP and are released when 
BACKUP terminates. LUNO 5 is assigned to the output diskette. LUNO 6 is assigned to the input 
diskette. LUNO 10 is assigned to the input file, and LUNO 1 1 is assigned to the output file. 

10.3 OPERATING PROCEDURE 

To load the Diskette Backup Utility and place it in execution under TX990, perform the following 
steps using the OCP: 

1 . Place the object module for BACKUP in the appropriate device and ready the device. 

2. Enter the appropriate command to load the module. For example: 

LP,CS2. Loads the object code from cassette drive 2. 

LP,DSC: BACKUP/SYS Loads the object code from diskette file 

DSC:BACKUP/SYS. 

3. Enter the appropriate command to execute the task. 

EX,10.TE. Execute the program just loaded. If the backup 

utility was linked to the system, the user need only to 
execute the task ID assigned to it at that time. 

To place the backup utility under execution using the Terminal Executive Development System, 
perform step 1 above. If the TXDS Control Program is not executing, bid task 16 16 if OCP is active. 

EXECUTE, 16.TE. 
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TXDS lists its heading and asks for input as follows: 

TXDS 936215 ** 011/77 2:10 

PROGRAM : DISC : BACKUP/SYS * 

The user enters DSC: BACKUP/SYS* in response to the prompt: "PROGRAM:" The object code in 
the diskette file, DSC: BACKUP/SYS, is loaded and executed by the control program. Alternatively, 
the user can enter the cassette drive name. 

PROGRAM: CS1* 

Then the object code on cassette drive 1 is loaded and executed. 

1 0.4 USER INTERACTION WITH THE BACKUP UTILITY 

When BACKUP is executed, it displays a heading: 

BACKUP & INITIALIZE UTILITY PART NO. 9362 13*B 

After the heading is displayed, BACKUP requests the output diskette name: 

OUTPUT DISC OR VOLUME NAME? 

The user enters either a device name or the volume name of the diskette to be initialized or copied 
to. 

NOTE 

A user response of "*" to any BACKUP prompts terminates the 
utility. A user response of "&" to any prompt returns BACKUP to 
the above prompt, "OUTPUT DISC OR VOLUME NAME?". 

After the user specifies the output diskette, BACKUP checks it to see if it is initialized. If so, 
BACKUP prompts the following: 

DELETE ALL FILES ON XXXX? (Y/N) 

where XXXX is the output device name. The user enters Y if he desires to delete any preexisting 
files on the diskette. BACKUP clears all directory entries and resets the allocation bit map on the 
diskette. If the user enters N, BACKUP prompts the "INITIALIZE XXXX" message as described 
below. 

If the output diskette is not initialized, BACKUP displays the following: 

THE OUTPUT DISC MUST BE INITIALIZED 

If the diskette must be initialized, or the user response to the "DELETE ALL FILES" message was 
N, BACKUP prompts the following: 

INITIALIZE XXXX? (Y/N) 
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where XXXX is the output device name. If the user answers Y, the diskette is initialized. BACKUP 
prompts the message: 

OUTPUT DISC ID 

The user must enter a 1 to 32 character title for the diskette. The title is displayed by the SYSTUL 
Map Disc (MD) command. The following message is then displayed: 

OUTPUT VOLUME NAME 

The user may enter a 1 to 4 character volume name. The volume name will be used to access files on 
the diskette if volume name support is included in the user's customized TX990 Operating System. 
The volume name should not be the same as a device name. If the user enters only a carriage return, 
no volume name is defined for the diskette. Diskette initialization takes about four minutes. 

In order to copy files to a diskette without destroying all of the files on the diskette, the user must 
respond N to both the "DELETE ALL FILES" and "INITIALIZE" prompts. 

After the diskette is initialized, erased, or left intact, the user may copy and/or verify the files on 
any diskette. BACKUP prompts the following two messages, in order: 

COPY FILES? (Y/N) 
VERIFY FILES? (Y/N) 

If the user responds with a Y to either prompt, BACKUP requests the pathname of the files to be 
copied/ verified, as follows: 

INPUT PATHNAME? 

Valid responses must have one of the following formats. 

VOL ENTIRE DISKETTE 



\rr\j .t?tt t: I 



:FILE/ 
VOL/EXT 

/EXT 

VOL:FILE/EXT 
VOL:FILE 
.FILE/EXT 
:FILE 



THIS FILE NAME 

ALL FILES ON DEFAULT DISKETTE WJTH THIS FILE 

NAME 

ALL FILES ON THE DISKETTE OR VOLUME WITH 
THIS EXTENSION 

ALL FILES ON DEFAULT DISKETTE WITH THIS 
EXTENSION 

ONLY THIS FILE 

ONLY THIS FILE 

THIS FILE FROM THE DEFAULT DISC 

THIS FILE FROM THE DEFAULT DISC 
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where 



VOL = DISKETTE NAME OR VOLUME NAME 

FILE = FILE NAME 

EXT = FILE NAME EXTENSION 



If the output diskette already contains a file with the same name as one of the input files, the 
existing file is deleted and the copied file replaces it. After the specified files are copied and/or 
verified, BACKUP repeats the sequence with the "COPY FILES" prompt. 

When the user responds N to both the "COPY FILES" and "VERIFY FILES" prompts, BACKUP 
prompts the user to designate a system file. A system file is the image of a TX990 system which 
may be booted (eg. :SYSASR/CMP). To insure that the file is on the output diskette, the diskette 
name is also prompted, as follows: 

SYSTEM FILE PATHNAME? DSC2 : 

where DSC2 is the value given by the user in response to the "OUTPUT DISC" prompt. 

The user may then enter the name of a file on the output diskette which is to be the system file. If 
only a carriage return is entered, no system file is designated. 

After the "SYSTEM FILE" prompt, BACKUP returns to the "OUTPUT DISC OR VOLUME 
NAME" prompt. The utility may be terminated by a response of "*" to any prompt. 

When BACKUP terminates, it displays the following message: 

BACKUP & INITIALIZE UTILITY ENDED 

10.5 ERROR MESSAGES AND RECOVERY 



Error 

The OUTPUT DISC IS 
NOT USABLE. BACKUP 
UTILITY ABORTED. 



Reason 

Bad diskette 



Recovery 

Get another diskette. 



pathname DOES NOT 
VERIFY. 



Bad copy 



Rerun the backup utility. 



pathname WAS EMPTY. 



A file was created on the input 
file but was never used. 



DISC NAMES CANNOT 
BE THE SAME. 

THE OUTPUT DISC 
MUST BE INITIALIZED. 

pathname WAS UNSUC- 
CESSFULLY OPENED. 



User entered same name for input 
and output disc names. 

Output diskette has never been 
initialized. 

Disc was offline or diskette 
was full. 



Reenter the disc names. 



Execute the diskette 
initialization program. 

Ready the disc. 



10-4 



Digital Systems Division 




946259-9701 



Error 

COULD NOT GET 
MEMORY. BACKUP 
UTILITY ABORTED. 



Reason 

There is not enough memory 
to run the backup utility. 



Recovery 



pathname HAD AN I/O 
ERROR, CODE nn. 



THE INPUT DISC HAS 
A BAD DIRECTORY RECORD, flaw in that 
THE FILES IN THAT RECORD record. 
WERE NOT COPIED. 



nn is the error code; see error 
appendix I. 

j. here is a diskette 



Correct problem. Rerun 
backup utility. 

JNone. 



THE OUTPUT DISC HAS 
A BAD DIRECTORY 
RECORD. THE OUTPUT 
DISC IS NOT USABLE. 



There is a Diskette 
flaw on the output 
diskette. 



Disregard the diskette. 



DISC I/O ERROR CODE NN. 



nn is the error 
code; see 
Appendix I — I/O 
Error Codes. 



Correct error and 
retry. 



FILE NOT FOUND. 



The system file 
does not exist. 



NOTE 



Select another 
file as the system 
file. 



The pathname parameter will be filled in with the actual pathname of the file. 
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SECTION XI 
OBJECT MANAGER (OBJMGR) UTILITY PROGRAM 



11.1 INTRODUCTION 

The Object Manager (OBJMGR) Utility Program is used to collect object modules from several 
different diskette or cassette files and combine them into a single output file. The ability to do so is 
especially necessary when preparing to link ail of the modules of a customized TX990 Operating 
System, since the TXDS Linking Utility can only accept up to three input files. 

11.2 LUNOs 

The OBJMGR Utility Program uses LUNO 0, LUNO 4, and LUNO 5. The system console, which is 
assigned to LUNO 0, is used by the OBJMGR Utility Program to request operator input 
information. LUNO 4 is used to read the input file, and LUNO 5 is used to write the output file. 
Both LUNO 4 and LUNO 5 are assigned and released by the OBJMGR Utility Program. 

11.3 LOADING OBJMGR 

OBJMGR executes using the TX990 Operating System in conjunction with the OCP module, or 
with the TXDS Control Program, or using the DX10, release 2.2 Operating System. The following 
paragraphs describe how to load and execute OBJMGR under each operating system. 

11.3.1 LOADING OBJMGR USING THE TX990 OPERATING SYSTEM AND OCP. Load the 
program as follows: 

1 . After loading the OCP in accordance with the procedure itemized in the section in this 
manual entitled Operator Communication Package, observe the printout or display on the 
system console of the period (.) prompt. 

2. Place the object module for OBJMGR in either the cassette or diskette drive and ready 
the device. 

3. Using the LP (Load Program) command, load the OBJMGR object module from a 
cassette or diskette by using one of the following indicated methods: 

• LP,CS1,3 Load OBJMGR at priority level 3 when the object 

module is on the cassette in cassette drive 1 . 

• LP,DSC:OBJMGR/SYS. Load OBJMGR from the diskette in diskette drive 1. 

4. Enter the EX (Execute) command to execute OBJMGR and terminate OCP as follows: 

.EX,10.TE. 

5. Observe the following printout or display on the system console when OBJMGR begins 
execution: 

990 OBJECT MANAGER 939870** 
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11.3.2 LOADING OBJMGR USING THE TX990 TERMINAL EXECUTIVE DEVELOPMENT 
SYSTEM. Load the program as follows: 

1 . Place the object module for OBJMGR in either the cassette or diskette drive and ready 
the device. 

If the TXDS control program is not active enter an "!" and observe the following display: 

TXDS 936215 *A 088/77 3:14 
PROGRAM: 

2. When the OBJMGR object module is in cassette drive 1 5 enter "CS1*" in response to the 
prompt, as follows: 

PROGRAM CS1* 

When the OBJMGR object module is on a diskette file called :OBJMGR/SYS, enter the 
following: 

PROGRAM: :OBJMGR/SYS* 

3. Observe the following printout or display on the system console when OBJMGR begins 
execution: 

990 OBJECT MANAGER 939870** 

11.3.3 LOADING AND EXECUTING OBJMGR USING DX10, RELEASE 3.0. Perform the 
following steps on a DX10 release 3.0 system: 

1. Place the OBJMGR object module in some sequential media which is readable by DX10. 
If the module is on cassette, place it in a cassette drive. If the module is on a diskette file, 
use the TXDX conversion utility available under DX10 to convert the object module file 
to a DX 10 file. 

2. Install the object module as a task, using the DX10 IT command: 

IT PF = .SPROGA, TN = OBJMGR, OBJ = <acnm> 

where <acnm> is the DX10 access name of the file or device which contains the object 
module. 

3. Execute the object manager, using the DX10 XTS command. 

XTS TN = OBJMGR 

4. Upon execution, OBJMGR displays the following message: 

990 OBJECT MANAGER 9456?2*C 
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11.4 OPERATOR INTERACTION 

After the initial heading is displayed, the object manager requests the following information: 



OUTPUT FILE: < pathname of a sequential file or device> 
INPUT FILE: < pathname of a sequential file or device> 
REWIND INPUT FILE? 



{«} 



TDT of an object module"? ( C 

S 
I 

R 
A 
D 

NOTE 

If an "*" is entered in response to any prompt, OBJMGR writes an 
end-of-file to the output file, closes the file, releases all LUNOs and 
terminates. If an "&" is entered, OBJMGR performs all of the above 
except terminate; it then restarts with the "OUTPUT FILE" prompt. 

The first prompt made by OBJMGR is the following: 

OUTPUT FILE: 

The user must enter a complete pathname for a sequential device or file. There are no defaults. 
DX10 users must not use synonyms. The object modules selected by the user in later steps are 
written to this pathname. 

The next prompt is the folio wing: 

INPUT FILE: 

The user must enter the name of a sequential file or device which contains object modules to be 
edited onto the output file. In addition to modules on this input file, the user may insert new 
modules from other files. 

4 

After the input file pathname is entered, OBJMGR prompts the following: 
REWIND INPUT FILE? 

The user must answer either Y (yes, rewind the input file) or N (do not rewind the file). 

After the input file is ready, OBJMGR reads the first record, and displays the IDT (see the 
Assembly Language Programmer's Guide) for that module, followed by a question mark. The user 
may then choose to include or exclude that module from the output file, or to insert modules from 
other files, by entering one of the following action commands: 

C — copy the object module 

S - skip the object module 

I — insert object modules from other files 
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R - replace this module with modules from other files 

(combination of S and I) 
A - copy all remaining object modules in the input file 
D — done with this input file; leaves the file positioned 

at the current IDT for future use. 

The Copy (C) command causes the object manager to copy the module with the displayed IDT to 
the output file. 

The Skip (S) command causes OBJMGR to skip the module with the displayed IDT without 
copying it. 

The Insert (I) command allows the user to insert modules from another file (the insert file) onto the 
output file, before the module with the displayed IDT. After the I command is given, OBJMGR 
prompts the "INPUT FILE" and "REWIND" messages. The user enters the new file, and Y or N, 
and OBJMGR reads the first record of the new input file and displays the IDT of the first object 
module. The user may enter any of the action commands except I or R. After the user enters a 
Done (D) command, OBJMGR skips several lines and displays a line of asterisks, followed by the 
IDT that was displayed when the Insert command was entered. If an end-of-file on the insert file is 
read, an "END-OF-FILE" message is displayed, followed by the IDT that was displayed before the 
Insert command. The user may then enter any command. 

The Replace (R) command causes OBJMGR to skip the object module with the displayed IDT, and 
then insert modules from another file (the replace file). After skipping the original module, the 
Replace command executes exactly like the Insert command. 

The All (A) command causes the object manager to copy all of the remaining object modules in the 
input file to the output file, and then resume execution at the "INPUT FILE" prompt. 

The Done (D) command causes OBJMGR to backspace the current file one record (so that the IDT 
which was displayed will be displayed next time the file is opened without rewind). If D is issued 
while processing a Replace or Insert command, OBJMGR resumes prompting of IDTs on the 
original input file. If D is issued for the input file, execution is resumed by prompting for a new 
"INPUT FILE". 

11.5 ERROR MESSAGES 

Table 11-1 shows the error messages which may be returned by OBJMGR. 
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Error Message 
CAN'T ASSIGN I/O 



INPUT ERROR 



CAN'T OPEN I/O, 
TERMINATING 



INVALID IDT RECORD 



INPUT ERROR, 
RETRY? 



OUTPUT FILE ERROR, 
TERMINATING 



EOF EMBEDDED IN 
OBJECT MODULE 



INVALID COMMAND 
C = COPY, S = SKIP, 
R = REPLACE, I = INSERT, 
D = DONE, A = ALL 



Table 11-1. Error Messages 
Description 

Attempt to assign LUNO 
for input or output was 
unsuccessful. 



I/O error during keyboard entry. 



lirror during open operation for 
input or output. 



First record of object module 
does not contain identifier. 



Error while reading input file. 



Error while writing output file. 



An end-of-file record has been 
detected in object module. 



Invalid response to request. 



Recovery 

Check device name, and enter 
correct name. If system capacity 
for active LUNOs has been reached, 
release a LUNO that is no longer re- 
quired. The user may terminate 
Object Manager and attempt to 
assign the LUNO with an ALUNO 
command to obtain a more 
specific error message. 

Try again. If error persists, check 
input device and interface. 

Object Manager terminates. 
Obtain correct object module or 
add proper first record and restart 
Object Manager. 

Object Manager terminates. Obtain 
correct object module or add 
proper first record and restart 
Object Manager. 

Enter N to use the record as read. 
Enter Y to backspace and reread 
the record. When record is a card, 
user must remove card from output 
stacker and place it in input hopper. 
Enter a carriage return to terminate. 

Object Manager terminates. Correct 
the problem and restart Object 
Manager. 

Object Manager terminates. Obtain 
correct object module or remove 
misplaced record and restart 
Object Manager. 

Enter correct response. An 
asterisk terminates OBJMGR, and 
an ampersand (&) restarts it. 
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SECTION XII 
LIST80/80 (LIST80) UTILITY PROGRAM 

12.1 LIST80/80 

The LIST80/80 utility program copies 80-character records from one device or file to another. 
Optionally, LIST80/80 adds carriage control characters for displaying or printing. All files must 
previously have been created and all files and devices must previously have been rewound. 
LIST80/80 can be run from OCP control only and cannot be run using the TXDS Control Program. 

12.1 .1 LOAD AND EXECUTING LIST80/80. To execute LIST80/80, place the object code in the 
appropriate device and perform the following steps: 

NOTE 

When LIST80/80 is linked into the Operating System during system 
generation, step 1 does not apply. 

1. Enter a command to load LIST80/80 in the dynamic task area. The following are 
examples of commands to install LIST80/80: 

.LP,CS1,3. Load task LIST80/80 at priority level 3 when the 

object module is on cassette unit 1 . 

.LPROG,CR,3. Load task LIST80/80 at priority level 3 when the 

object module is in the card reader. 

.LP,:LIST80/SYS,3. Load task LIST80/80 at priority level 3 when the 

object module is in the disc file DCS:LIST80/SYS. 

1 A _„: T T TXT/^V 1 A 4-~ +U^> !««ii^ /ln,Tri^Q TVta fn'Wrwtri n r» ovomr\1o di^t-NliAe \irVlon tVlf innilt 

L. /\SSJ.g\Il I-jKJI'WJ lyJ \6 lu llic l 11 P ul U^VIV^. HIV iuiiu wing, ^/vmiipj.^ ujjjyuvo niivn uiv ui^i" 

device is Cassette Unit 2. (The cassette must have been written in the line mode with 
records that contain 80 or fewer characters.) 

.ALUNO,10,CS2. 

3. Assign LUNO ll i6 to the output file. The following example applies when the output 
file is DSC2:SOURCE/SRC. 

.ALUNO,l l,DSC2:SOURCE/SRC. 

4. Enter the following command to execute LIST80/80 and terminate OCP. 

.EXECUTE, 10.TE. 

NOTE 

When LIST80/80 is linked into the system during system genera- 
tion, the task identifier assigned during system generation is used 
instead of 10 in the command in step 4. 
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5. LIST80/80 displays a title and part number heading, as shown: 

LIST80/80 937976*A 

6. LIST80/80 reads the records from the input device, adds carriage control characters, 
and writes the records to the output device. 

7. When LIST80/80 finishes, a message is displayed on the LOG. 

LIST80/80 TERMINATED 

When the output device is a cassette unit, LIST80/80 does not add carriage control characters. 
An alternative command may be entered in step 4, as follows: 

.EXECUTE,10,FFFF.TE. 

When the Execute command is entered in this form (or with any nonzero value instead of FFFF), 
LIST80/80 does not add carriage control characters to the output record, regardless of the output 
device. 

12.1.2 LIST80/80 ERROR MESSAGES. LIST80/80 prints two error messages. One error message 
prints as follows: 

ERROR DETECTED ON OPEN OF LUNO 10 OR 1 1 

The possible reasons for this error are: 

• LUNO 10 assigned to an inappropriate device. 

• LUNO 1 1 assigned to an inappropriate device. 

• An error other than busy was returned by the OPEN supervisor call. 

The following error message is printed when an unsuccessful read operation occurs on LUNO 10: 

READ ERROR ON LUNO 10. 
The following error message is printed when an unsuccessful write operation occurs on LUNO 10: 

WRITE ERROR ON LUNO 1 1 . 
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SECTION XIII 
DISKETTE DUMP (DSKDMP) UTILITY PROGRAM 

13.1 INTRODUCTION 

The Diskette Dump Utility (DSKDMP) Program allows users to load, dumrj and modify FD800 
Floppy Disc diskettes on an allocation unit (AU) basis. (Refer to Section IV of this manual for 
a description of the allocation unit and its application to file management.) The utility can be 
executed from either OCP or TXDS. 

In addition to the diskette, a V91 1 or V913 Video Display Terminal is required. 

13.2 LUNOs 

Diskette Dump uses Video Display Terminal (VDT) station number 1, LUNO 4 and LUNO 1. 

It uses VDT station number 1 to display sectors to the user and accept commands from the user. 
It assigns LUNO 4 internally to the floppy -disc drive whose diskette is being dumped, loaded, or 
modified. 

The utility uses LUNO 1 when the print directive (P) is entered. Therefore, the user must assign 
LUNO 1 before the print directive is exercised. 



13.3 LOADING PROCEDURES 

To load the Diskette Dum n Utili 

entering commands at the keyboard of the system console. 



Tn lour! thp nielrpttp Fliimn TTtilitv anrl PYPnifp it n«ino OPP nprfnrm tVip fnllnwina sfpn« V»v 



1. Place the object module for Diskette Dump in the appropriate device and ready the 
device. 

2. Enter a command to install Diskette Dump in the dynamic task area. The following are 
examples of load program (LP) commands to install Diskette Dump: 

.LP,CS1. Load Diskette Dump at priority level 3 when the object module 

is Cassette Unit 1 . 

.LP,CR. Load Diskette Dump at priority level 3 when the object module 

is in the Card Reader. 

3. Assign LUNO 1 to a printing device if the print directive is to be exercised. The following 
is a sample command : 

.AL,1 ,LP. Assign LUNO 1 to the line printer. 

4. Enter a command to execute Diskette Dump and terminate OCP, as follows: 

.EXECUTE, 10.TE. 

If Diskette Dump was linked into the system at system generation, the load program command is 
not entered and the operand of the execute command (EXECUTE) is the task identifier assigned to 
Diskette Dump when the system was generated. 
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To initiate execution of the Diskette Dump utility using the Terminal Executive Development 
System perform step 1 above, followed by the steps below: 

1. Bid TXDS control program when OCP is not active by entering "!". Otherwise, enter "!" 
to bid OCP and enter "EX,16.TE." to bid TXDS control program. 

2. The TXDS control program displays a heading and prompts for input as follows: 

TXDS 936215 *A 011/77 2:10 
PROGRAM: 

3. Enter :DSKDMP/SYS* in response to the prompt as follows: 

PROGRAM: :DSKDMP/SYS* 

13.4 OPERATING PROCEDURES 

Upon execution, an initial mask is displayed on the station number 1 VDT with the cursor 
positioned to the first field of the command line. 

The following shows the initial VDT mask: 

990 DISKETTE DUMP/LOAD 937562** 

00-0F 
10-1F 
20-2F 
30-3F 
40-4F 
50-5F 
60-6F 
70-7F 

DISC: AUNO: SECTOR:_ 

The cursor is positioned under the first space after DISC:. The user now must enter, in the proper 
field of the command line, the disc drive name, AU number and sector number which is to be dis- 
played on the VDT. To advance from one field of the command line to the next, the user either 
enters the maximum number of characters allowed in the field or presses the TAB key. To return 
to a previous field, the user presses the NEW LINE key. For example, if the cursor was positioned 
at the SECTOR: field and the user wished to return to the DISC: field, the user would press the 
NEW LINE key twice. 

Each time data is entered in a field, the utility validates the data. If the data is not correct, the 
message WRONG! is displayed in the lower-right-hand corner of the VDT screen. Before the user 
may advance from one field to the next, valid data must be entered in the field from which the 
user wishes to advance. The following is a list of restrictions on the values for each of the command 
line fields: 

DISC: Requires a one- to four-character disc-drive name. This name is determined at 

system generation time. 

AU NO: Requires a one- to three-digit decimal number. The range of AU numbers is 

to 332. Leading zeros are not required. Hitting the TAB key without 
entering a number causes a zero to be entered. 

SECTOR: Requires a one-digit decimal number. The range of the sector number is to 5. 

Hitting the TAB key without entering a number causes zero to be entered. 
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After the user has entered the disc-drive name, AU-number, and sector-number parameters, the 
utility displays the sector on the VDT, indicates the mode of the data being displayed (either 
ASCII, EBCDIC, or hexadecimal and positions the cursor, as indicated by the blinking light, to 
accept utility directives. The following is an example of the VDT display: 
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The user can now enter one of the Blinking Cursor one-character directives indicated in table 13-1. 
The following paragraphs define these functions. 

13.4.1 INCREMENT SECTOR NUMBER (I). This directive increments the number of the sector 
being displayed and causes the new sector to be displayed. If the new sector number goes beyond 5,. 
the first sector (sector 0) of the next AU is displayed. 

13.4.2 DECREMENT SECTOR NUMBER (D). This directive decrements the number of the sector 
being displayed and causes the new sector to be displayed. If the new sector number goes lower 
than 0, the last sector (sector 5) of the previous AU is displayed. 

13.4.3 PRINT DISPLAY (P). This directive causes the displayed sector to be written to the hard- 
copy device assigned to LUNO 1. After P is input, the following message is displayed: 

PRINT? (Y/N) 

The user can then assign LUNO 1 to the hard-copy device, if it has not already been done. The fol- 
lowing is an example of the command that mav be entered on the system console. 

.AL,l,LOG.TE. 

After assigning LUNO 1, the user types a Y on the VDT and the output is performed. Typing an N 
indicates to the utility that the user decided not to print the display and so the printing process is 
not started. 

13.4.4 SET DATA MODE TO ASCII (A). This directive causes the sector data to be interpreted 
and displayed in ASCII format. 

13.4.5 SET DATA MODE TO EBCDIC (E). This directive causes the sector data to be interpreted 
and displayed in EBCDIC format. 
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Table 1 3-1 . Diskette Dump Utility Directives 
Directive Function 

I Increment sector number 

D Decrement sector number 

P Print display 

A Set data mode to ASCII 

E Set data mode to EBCDIC 

H Set data mode to Hexadecimal 

M Modify displayed sector data 

New-Line-Position cursor to SECTOR: field. 



13.4.6 SET DATA MODE TO HEXADECIMAL (H). This directive causes the sector data to be 
displayed in hexadecimal format. 

Figure 12-1 shows the same sector displayed in the three different modes: ASCII, EBCDIC and 
hexadecimal. The displayed sector is grouped into 8-bit (byte) fields. Therefore on each line of the 
display there are 16 bytes of the sector displayed. On the hexadecimal (hex) display each byte is 
represented by two hexadecimal characters. On the ASCII and EBCDIC displays, each byte is 
represented as either a two-character upper-case ASCII or EBCDIC character (first character is 
blank), a two-character lower-case ASCII or EBCDIC character (first character is a "."), or if the 
byte of data has no ASCII or EBCDIC representation, the two-character hexadecimal value is 
displayed. 

13.4.7 MODIFY DISPLAYED SECTOR DATA (M). This directive allows a user to modify the 
displayed sector data. After the user enters the directive, the following message is output: 

MODIFY? (Y/N): 

If the user types N, the utility stops the modify operation. If the user types Y, the cursor positions 
to the first byte displayed for the sector (upper-left-hand corner of the display). The user may move 
the cursor about with the "arrow" keys up, down, right and left. Hexadecimal characters may be 
entered by entering the two character hex value. An ASCII character may be entered by typing 
a blank followed by the desired ASCII character. An EBCDIC character may be entered by typing 
a period followed by the desired EBCDIC character. After all changes have been made, the "new 
line" character must be entered. This causes the following message to be output: 

RE-WRITE DISC?: 

If the user types N, the modify operation is terminated without modifying the data on the disc. 
If the user types Y, the modified sector is written to disc. 

13.4.8 POSITION CURSOR TO SECTOR: FIELD (NEW LINE). Typing New Line causes the 
cursor to position to the SECTOR: parameter field. Typing this character three more times causes 
Diskette Dump to terminate. It outputs the following message on the VDT screen. 

**** END OF PROGRAM **** 
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13.5 ERROR MESSAGES 

The following error messages can be generated during execution of DSKDMP: 



WRONG! 



An attempt was made to input invalid parameters, command directives, 
or to perform an invalid operation or LUNOs were not available to the 
task. 



DISC ERROR Either a disc hardware error occurred or an attempt was made to read 

a nonexistent AU. 
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Figure 13-1. Three Modes of Sector Display 
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APPENDIX A 

LIST OF SUPERVISOR CALLS FOR USER TASKS AND 
FILE MANAGEMENT OF I/O DEVICE-FILES 



Table A-l lists the supervisor calls available to the user. The call code, the hexadecimal value to be 
placed in byte of the supervisor call block (SCB), is shown in the first column. The name of the 
supervisor call is listed in the second column, followed by the byte-size of the supervisor call block 
in the third column. The fourth column contains an X if the (SCB) must be word-aligned. The fifth 
column contains a brief description of the results of the supervisor call. For a detailed description 
of each supervisor call, refer to Sections III and IV herein this manual. It should be noted that "R" 
signifies "Workspace Register" in table A-l below. 



Code Supervisor Call 

00 16 File Management 

01 16 Wait for I/O 



02, 



03, 



Time Delay 



Date and Time 



Table A-l . Supervisor Calls 
Byte Size Aligned 

Note 1 X Note 1 



Result 



Calling task suspended pending com- 
pletion of I/O operation defined in 
SCB at the address in bytes 2 and 3 of 
SCB. 

Calling task suspended for number of 
system time units in bytes 2 and 3 of 
SCB. 

Date and time returned in binary form 
in five-word area at address in bytes 2 

onrl "2 nfSfR 



04 16 


End of Task 


1 


05 16 


Bid Task 


Note 2 


06 16 


Unconditional Wait 


1 


07 16 


Activate Suspended 
Task 


3 


08 16 


Character Input 


3 


09 16 


Do Not Suspend 


2 



0Aj 6 Convert Binary to Decimal 8 



Calling task terminated. 

Task (ID in byte 2 of SCB) is bid. 

Calling task suspended unconditionally. 

Suspended task (ID in byte 2 of SCB) is 
activated. 

Input character from station keyboard 
(ID in byte 2 of SCB); place in R0. 

Inhibit suspension of calling task by sys- 
tem for number of system time units de- 
termined by contents of byte 1 of SCB. 

Convert binary value in R0 to decimal 
ASCII characters; place in bytes 2 
through 7 of SCB. 
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Code 

0B 16 

0C 16 
0D, fi 



0E 



16 



OF, 



10, 



11 



12 



16 



16 



13, 



15, 



16 



16 



17, 



1A, 



Table A-l. Supervisor Calls (Continued) 
Supervisor Call Byte Size Aligned 



Convert Decimal to Binary 8 



Convert Binary to Hexa- 
decimal 



Convert Hexadecimal to 
Binary 

Activate Time Delay Task 

Abort I/O 

Get COMMON Data 
Address 

Change Priority 
Get Memory 



Release Memory 
File Management 

End of Program 
Get Parameters 



Conditional Character 
Input 



VDT Utility 



12 



12 



X 



Result 



Convert decimal ASCII characters in 
bytes 2 through 7 of SCB to binary 
value; place in R0. 

Convert binary value in R0 to hexadeci- 
mal ASCII characters; place in bytes 2 
through 5 of SCB. 

Convert hexadecimal ASCII characters 
2 through 5 of SCB to binary value 
place in R0. 

Time delay task (ID in byte 2 of SCB) is 
activated. 

I/O in progress with LUNO in byte 1 is 
terminated. 

Address of COMMON area in R9; size 
inR8. 

Priority of calling task changed to value 
in byte 1 of SCB. 

The number of 32-byte blocks of 
memory requested in bytes 2 and 3 of 
the SCB is allocated and the address of 
the first block is placed in R9. 

Included for compatibility with DX10; 
performs no operation. 

The file management operation defined 
in the SCB (Assign or Release LUNO) is 
performed. 

Operation bids the rebid task which is 
usually the TXDS Control Program. 

Task parameters are placed in bytes 2 
through 5 of SCB. 

Bit 2 of Status Register set to one and 
character from station keyboard (ID in 
byte 2 of SCB) placed in R0, or bit 2 set 
to zero if no character available. 

The VDT I/O operations defined in the 
SCB are performed. (Write or read 
characters, open or close I/O, position 
cursor or tab.) 
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Table A-l . Supervisor Calls (Continued) 



Code 


Supervisor Call 


Byte Size 


Align 


IB16 


Return COMMON 


1 




1Ci« 


Put Data 


14 


X 


ID* 


Get Data 


14 


X 


1E 16 


Abort I/O SVC 


4 


X 


20 16 


Get Own ID 


2 




21 1« 


Get System Table 


4 


X 


23 16 
es: 


Make Task Privileged 


■-I 





Result 



Included for compatibility with DX10; 
performs no operation. 

Put message on message queue. 

Get message from message queue. 

Abort I/O on specific SVC. 

Task ID returned in byte 1 . 

System table address returned in bytes 2 
and 3. 

Makes the task privileged. 



1. Size of SCB for File Management supervisor call includes 2-byte SCB and 10- or 14- or 22-byte SCB. I/O 
operation defined in SCB is performed. 



2. Size of SCB for Bid Task supervisor call is 3, 6, or 8 bytes. When two optional parameter words are included 
8 bytes are requir 
bytes are required 



8 bytes are required; when a single optional paianieter woru is in&Uueu, o uytes are requireu; otherwise, j 
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APPENDIX B 
DEVICE CHARACTER SETS 

The TX990 Operating System supports ASCII I/O operations with all devices. This section lists the 
character sets for the devices and the end-of-record and end~of-file sequences for the devices. 

Table B-l. 911 Video Display Terminal Character Set 
End-of-Record - NEW LINE (CR) 

Character Hexadecimal 

1 31 

2 32 

3 33 

4 34 

5 35 

& 26 

27 
( 28 

) 29 

* 2A 

+ 2B 

2C 

2D 

2E 
/ 2F 

30 



Character 


Hexadecimal 


Space 


20 


i 


21 


» 


22 


# 


23 


S 


24 



7 


37 


8 


38 


9 


39 


: 


3A 


j 


3B 


< 


3C 


= 


3D 


> 


3E 


9 


3F 


@ 


40 


A 


41 



Character 


Hexadecimal 


B 


42 


C 


43 


D 


44 


E 


45 


F 


46 



H 


48 


I 


49 


J 


4A 


K 


4B 


L 


4C 


M 


4D 


N 


4E 





4F 


P 


50 


Q 


51 


R 


52 
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Character 


Hexadei 


S 


53 


T 


54 


U 


55 


V 


56 


w 


57 


X 


58 


Y 


59 


Z 


5A 


[ 


5B 


\ 


5C 


] 


5D 


A 


5E 





5F 



Table B-l . 91 1 Video Display Terminal Character Set (Continued) 

1 Character Hexadecimal Character Hexadecimal 

a 61 n 6E 

b 62 o 6F 

c 63 p 70 

d 64 q 71 

e 65 r 72 

f 66 s 73 

g 67 t 74 

h 68 u 75 

i 69 v 76 

j 6A w 77 

k 6B x 78 

1 6C y 79 

m 6D z 7A 



Notes: 

1 . Entering left arrow («-) backspaces the cursor and deletes the character in the buffer. 

2. Entering right arrow (->) moves the cursor one column to the right and places the character in the buffer. 

3. Entering ERASE FIELD moves the cursor to the first character of the line, clears the characters on the line, and 
deletes those characters in the buffer. 

4. Entering RETURN positions the cursor at the first character of the next line and terminates the record. 
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Table B-l. 911 Video Display Terminal Character Set (Continued) 

Notes (Continued): 

5. Table B-l applies to the record and file modes only. 

6. The maximum buffer size for record or file mode VDT is 82 characters. 

7. Pressing the space bar stops output in record mode. Pressing the space bar again restarts output. 

8. Pressing the ESC key terminates output. 

9. Entering a tab stores 09 i6 in the buffer and writes a space to the screen. 
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Table B-2. 913 Video Display Terminal Character Set 
End-of-Record - NEW LINE (C/R) 



Character 


Hexadecimal 


Character 


Hexadecimal 


Character 


Hexadecimal 


Space 


20 


6 


36 


L 


4C 


i 


21 


7 


37 


M 


4D 


n 


22 


8 


38 


N 


4E 


# 


23 


9 


39 





4F 


$ 


24 




3A 


P 


50 


% 


25 


5 


3B 


Q 


51 


& 


26 


< 


3C 


R 


52 


' 


27 


= 


3D 


S 


53 


( 


28 


> 


3E 


T 


54 


) 


29 


? 


3F 


U 


55 


* 


2A 


@ 


40 


V 


56 


+ 


2B 


A 


41 


w 


57 


> 


2C 


B 


42 


X 


58 


- 


2D 


C 


43 


Y 


59 




2E 


D 


44 


z 


5A 


/ 


2F 


E 


45 


[ 


5B 





30 


F 


46 


\ 


5C 


1 


31 


G 


47 


] 


5D 


2 


32 


H 


48 


A 


5E 


3 


33 


I 


49 


- 


5F 


4 


34 


J 


4A 






5 


35 


K 


4B 
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Table B-2 . 9 1 3 Video Display Terminal Character Set (Continued) 

Notes: 

1 . Pressing the backspace arrow (<-) moves the cursor one column to the left and deletes the character in the buffer. 

2. Pressing the forward space arrow (-»•) moves the cursor one column to the right and places the character in the 
buffer. 

3. Entering DELETE LINE moves the cursor to the first character of the line, clears the characters on the line, and 
deletes those characters in the buffer. 

4. Entering NEW LINE positions the cursor at the first character of the next line and terminates the record. 

5. Entering TAB causes 09 16 to be stored in the buffer and a space to be written on the screen. 

6. Table B-2 applies to the record and file modes only. 

7. The maximum buffer size for record or file mode VDT is 82 characters. 

8. Pressing the space bar stops output in record mode. Pressing the space bar again restarts output. 

9. Pressing the RESET key terminates output. 
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Table B-3. 733 or 743 Data Terminal Character Set 

End-of-Record - C/R (applies to keyboard and cassette input only) 

End-of-file - DC3 (applies to keyboard and cassettes only) 



Character 


Hexadecimal 


Character 


Hexadecimal 


Character 


Hexadecimal 


Space 


20 


7 


37 


N 


4E 


i 


21 


8 


38 





4F 


a 


22 


9 


39 


P 


50 


# 


23 




3A 


Q 


51 


$ 


24 


3 


3B 


R 


52 


% 


25 


< 


3C 


S 


53 


& 


26 


= 


3D 


T 


54 


3 


27 


> 


3E 


U 


55 


( 


28 


? 


3F 


V 


56 


) 


29 


@ 


40 


w 


57 


* 


2A 


A 


41 


X 


58 


+ 


2B 


B 


42 


Y 


59 


j 


2C 


C 


43 


Z 


5A 


- 


2D 


D 


44 


[ 


5B 




2E 


E 


45 


\ 


5C 


/ 


2F 


F 


46 


] 


5D 





30 


G 


47 


A 


5E 


1 


31 


H 


48 


- 


5F 


2 


32 


I 


49 


« 


60 


3 


33 


J 


4A 


a 


61 


4 


34 


K 


4B 


b 


62 


5 


35 


L 


4C 


c 


63 


6 


36 


M 


4D 


d 


64 



B"*> Digital Systems Division 




946259-9701 



Character 



8 
h 
i 

J 
k 
1 
m 



Table B-3. 733 or 743 Data Terminal Character Set (Continued) 



Hexadecimal 

65 
66 
67 
68 
69 
6A 
6B 
6C 
6D 



Character 


Hexadecimal 


n 


6E 





6F 


P 


70 


q 


71 


r 


72 


s 


73 


t 


74 


u 


75 


V 


76 



Character 


Hexadecimal 


w 


77 


X 


78 


y 


79 


z 


7A 


{ 


7B 


1 


7C 


\ 


7D 


~ 


7E 



Notes: 

Keyboard: 



Printer: 



Cassette Input: 



1. BS character (08 16 ) is returned to printer as LF and BS. Deletes most recently entered 
character in buffer. 

2. HT character (09 16 ) is returned to printer as space. Character is placed in buffer. 

3. LF character (0Ai 6 ) is returned to printer as LF, but is not stored in buffer. 

4. CR character (0D, 6 ) is returned to printer as CR, and character is not placed in buffer. 
Character terminates the record. 

5. DC3 character (13 16 ) is not stored in buffer. When DC3 is first character of record, the 
record is an end-of-file record. 

6. ESC character (1Bi 6 ), when entered during output, terminates output with a write error. 

7. DEL character (7F 16 ) is returned to printer as a line feed and carriage return. Character 
deletes current input record. 

8. Maximum buffer size is 83 characters. 

1. BS character (08 16 ) results in a backspace operation. 

2. HT character (09 16 ) results in printing a space. 

3. LF character (0A 16 ) results in a line feed operation. 

4. FF character (0C 16 ) results in eight line feed operations. 

5. CR character (0D 16 ) results in a carriage return operation. 

6. End-of-record occurs when specified number of characters have been printed. 

7. Maximum buffer size is 83 characters. 

1. The characters LF (0A 16 ) and DEL (7F 16 ) or the character DEL at the beginning 
of a record are ignored. The first valid character of the record is the character 
following the DEL. 

2. The characters HT (09 16 ), FF (0C 16 ), BEL (07 16 ), and BS (08 16 ) are stored in the 
user's buffer. 

3. The character ETB (17i 6 ) is stored in the user's buffer as a CR (0D 16 ). 
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Table B-3. 733 or 743 Data Terminal Character Set (Continued) 

Notes: (Continued) 

4. The character DC3 (13 !6 ) as the first character of a record indicates an end-of-file 
record. The system returns end of file status after positioning the tape at the be- 
ginning of the next record. The DC3 is not stored in the buffer. 

5. The character CR (0Di 6 ) indicates end-of-record, and is not stored in the buffer. 

6. Maximum buffer size is 83 characters. 

Cassette Output: 1. The end of block character sequence is CR (0Di 6 ) LF (0A M ) DC4 (14 16 ) DEL (7F, 6 ). 
The end of file character sequence is DC3 (13 i6 ) CR DC4 DEL. These characters are 
supplied by the system, not by the user. 

2. The characters HT (09 16 ), FF (0Ci 6 ), BEL (07 16 ), and BS (08i 6 ) are written unchanged. 

3. The character CR (0D 16 ) is translated to ETB (17 ie ) and written. 

4. The character DC3 (13 w ) may be placed within a record, but may not be the first 
character of a record other than the end of file record. 

5. End-of-record occurs when specified number of characters have been written. 

6. Maximum buffer size is 83 characters. 
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Character 


Hexadecimal 


Row Pun 


Space 


20 


None 


! 


21 


11-8-2 



1 



Table B-4. Card Reader Character Set 
End-of-File /* (Cols. 1 and 2) 
Character 



Z.L 5-/ 

# 

$ 24 11-8-3 < 

% 

> 
? 

( 28 12-8-5 @ 

) 29 11-8-5 A 

ll-6-<* " 

C 
D 
E 
F 

/ 2F 0-1 G 

30 H 



23 


8-3 


24 


11-8-3 


25 


0-8-4 


26 


12 


27 


8-5 


28 


12-8-5 


29 


11-8-5 



2B 


12-8-6 


2C 


0-8-3 


2D 


11 


2E 


12-8-3 


2F 


0-1 


30 





31 


1 


32 


2 


33 


3 


34 


4 


35 


5 


36 


6 


37 


7 



I 



2 32 2 j 

3 33 3 k 

4 34 4 l 

5 35 5 m 

6 36 6 N 

7 37 7 O 



Hexadecimal 


Row Punches 


38 


8 


39 


9 


3A 


8-2 


3B 


11-8-6 


3C 


12-84 


3D 


8-6 


3E 


0-8-6 


3F 


0-8-7 


40 


84 


41 


12-1 



43 


12-3 


44 


124 


45 


12-5 


46 


12-6 


47 


12-7 


48 


12-8 


49 


12-9 


4A 


11-1 


4B 


11-2 


4C 


11-3 


4D 


114 


4E 


11-5 


4F 


11-6 
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Character 


Hexadecimal 


P 


50 


Q 


51 


R 


52 


S 


53 


T 


54 


U 


55 


V 


56 


w 


57 



Table B-4. Card Reader Character Set (Continued) 
End-of-File /* (Cols. 1 and 2) 
Row Punches Character 



11-7 

11-8 

11-9 

0-2 

0-3 

0-4 

0-5 

0-6 



X 

Y 
Z 

[ 

\ 



Hexadecimal 


Row Punches 


58 


0-7 


59 


0-8 


5A 


0-9 


5B 


12-8-2 


5C 


0-8-2 


5D 


12-8-7 


5E 


11-8-7 


5F 


0-8-5 



Notes: 

1 . End of record occurs when the specified number of characters, or 80 characters have been read. 

2. Maximum buffer size is 80 characters. 
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Character 


Hexadecimal 


Space 


20 


I 


21 


it 


22 


# 


23 


$ 


24 


% 


25 


& 


26 


» 


27 


( 


28 


) 


29 


* 


2A 



Table B-5. Line Printer Character Set 
Character Hexadecimal 

9 39 

3A 

; 3B 

< 3C 

3D 

> 3E 

? 3F 

@ 40 

A 41 

B 42 

C 43 

,-tn TN AA 

2C E 45 A 5E 

2D F 46 - 5F 

2E G 47 ' 60 

/ 2F H 48 a 61 

30 I 49 b 62 

1 31 J 4A c 63 

2 32 K 4B d 64 

3 33 L 4C e 65 

4 34 M 4D f 66 

5 35 N 4E g 67 

6 36 O 4F h 68 

7 37 P 50 i 69 

8 38 Q 51 j 6A 



Character 


Hexadeci] 


R 


52 


S 


53 


T 


54 


U 


55 


V 


56 


w 


57 


X 


58 


Y 


59 


Z 


5A 


[ 


5B 


\ 


5C 


i 
j 
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Table B-5. Line Printer Character Set (Continued) 



Character 


Hexadecimal 


Character 


Hexadecimal 


Character 


Hexadecimal 


k 


6B 


r 


72 


y 


79 


1 


6C 


s 


73 


z 


7A 


m 


6D 


t 


74 


1 


7B 


n 


6E 


u 


75 


1 


7C 





6F 


V 


76 


} 


7D 


P 


70 


w 


77 


~ 


7E 


q 


71 


X 


78 


DEL 


7F 



Notes: 



1 . Models 306 and 588 printers respond to the following control characters: 

BS (08 16 ) results in a backspace operation. 

HT (09 16 ) results in a single space. 

LF (0A 16 ) results in a line feed operation. 

CR (0D 16 ) results in a carriage return operation. 

FF (0C 16 ) results in a form feed operation. 

BEL (07i 6 ) results in a tone signal. 

The character SO (0Ei 6 ) results in character elongation for the line of characters following the SO. Elongation 
doubles the width of the characters, and a line of elongated characters contains one-half the number of 
characters on a normal line; i.e., 40 or 66. 

2. Models 2230 and 2260 printers respond to the following control characters: 

HT (09 16 ) results in a single space. 

LF (0A 16 ) results in a line feed operation. 

CR (0D 16 ) results in a carriage return operation. 

FF (0C 16 ) results in a form feed operation. 

Only characters 20 16 through 5F 16 are supported. All other graphics character codes are converted to blanks. 
The codes 5E 16 and 5F J6 produce the characters t and <-, respectively. 

3. The Model 810 printer responds to the various control characters and control character sequences as follows: 

CR (0D) Carriage return causes data in the printer buffer to be printed. The print head is left in its current 

position. 

LF (0A) Line feed causes data, if any, in the printer buffer to be printed and advances the paper one 

line. 

BEL (07) Bell results in a tone signal. 

BS (08) Backspace results in a backspace operation. 
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Table B-5. Line Printer Character Set (Continued) 



Notes: (Continued) 



HT (09) Horizontal Tab causes spaces to be entered in the printer buffer up to the next horizontal tab 

position. 

DC1 (1 1) Select selects the printer, enabling it to receive data. 

DC2, N (12, N) Tab to line causes the paper to advance to the line specified by N. N must be greater than 

current line position. 

DC3 (13) Deselect deselects the printer, preventing it from receiving data. 

DEL (7F) Delete clears the printer buffer of all characters. 

NUL (00) Null terminates the tab setting sequence (see below), otherwise it is ignored. 

DC4, N (14, N) Tab to column causes the carriage to advance to the column specified by N. N must be 

greater than the current column position, otherwise it will be ignored. 

ESC, 1 , Nl , N2, N3, . . ., NK, NUL (IB, 1 , Nl , N2, . . ., NK, 00) Set vertical tabs clears all existing tabs 

and sets new tabs at lines Nl , N2, . . ., and NK. 

ESC, 2, N (IB. 2, N) Set form length sets the form length used by the FF command to N. 

ESC, 3, Nl , N2, . . ., NK, NUL (IB, 3, Nl , N2, . . ., NK, 00) Set horizontal tab clears all existing horizontal 

tabs and sets new tabs at locations Nl , N2, . . ., NK. 

ESC, 4 (IB, 4) Sets paper drive system to 6 lines per inch. 

ESC, 5 (IB, 5) Sets paper drive system to 8 lines per inch. 

ESC, 6 (IB, 6) Sets print size to 10 characters per inch. 

ESC, 7 (IB, 7) Sets print size to 16.5 characters per inch. 

ESC, 8, M (IB, 8, M) Stores vertical format data, either vertical tab locations or form length (see note 1), 

into vertical format channel M (non-volatile internal printer memory). 

ESC, 9, M (IB, 9, M) Recalls vertical format data from vertical format channel M into working memory. 

This command has the same effect as issuing a set vertical tabs command or set form length. 

ESC, :, N (1B,3A,N) Converts printer from 132 position printer to one of N positions where 

2<N<127. 

ESC, ; (IB, 3B) Returns printing to normal 132 positions. 

All of the preceding commands may not apply if the printer does not have the particular option needed to execute 
the command. If the printer does not have the required hardware to execute the command, the command will be 
ignored. 

N, Nl , N2, etc, used in the ESC commands represent 7 bit binary numbers. If the parity option is selected on the 
printer, correct parity must be supplied here also. M is an ASCII number, where 1<M<8. Commas are used in 
the preceding commands for separators only and are not to be included in the commands. 
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Table B-5. Line Printer Character Set (Continued) 

Notes: (Continued) 

SO (0E) SO causes elongated character printing. The elongated character must be sent as the first character 
of the line and must precede each line printed in elongated characters. Also, with elongated print only 66 
characters per line are allowed. If more than 66 characters are sent, the excess are printed on the next 
line as standard, nonelongated characters. 

VT (OB) Vertical Tab causes data, if any, in the buffer to be printed and advances the paper to the next 
vertical tab location or top of form, whichever comes first. If no vertical tabs are set, a VT command causes 
the paper to advance to the top of the form. 

FF (OC) Form Feed causes data, if any, in the printer buffer to be printed and advances the paper to top 
of the next form. At Power Up, the lines per form is 66. 

For a write ASCII operation, the line printer DSR filters all control characters in the range 0— 1F 16 , except the 
following: 



BEL 


07 


Bell 


BS 


08 


Backspace 


HT 


09 


Horizontal tab (converted to a space) 


LF 


0A 


Line feed 


FF 


OC 


Form feed 


CR 


0D 


Carriage return 


SO 


0E 


Elongated character 


SI 


OF 


(ignored by the line printer) 



If the user wishes to use the full control character set, the Write Direct (0C) operation must be used. No characters 
will be filtered on a Write Direct (0C) operation. 

Note 1 : The two options, vertical forms control and form length, are mutually exclusive. The printer may have 
either option but not both. 
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Table B-6. ASR 33 Teletypewriter Character Set 







Printer 


Keyboard 


Punch (ASCII) 


Punch (Direct) 


END-OF-RECORD 


Depletion of 


CR 


Depletion of 


Depletion of 






character count 




character count 


character count 


END-OF-FILE 




N/A 
Reader (ASCII) 


DC3 
Reader (Direct) 


DC3 


N/A 


END-OF-RECORD 


CR 


DC3 






END-OF-FILE 




DC3 


N/A 






Character Hexadecimal Character 


Hexadecimal 


Character 


Hexadecimal 


Space 


20 


A 


41 


C 


63 


! 


21 


B 


42 


D 


64 


1> 


22 


C 


43 


E 


65 


# 


23 


D 


44 


F 


66 


S 


24 


E 


45 


G 


67 


% 


25 


F 


46 


H 


68 


£ 


26 


G 


47 


I 


69 


» 


27 


H 


48 


J 


6A 


( 


28 


I 


49 


K 


6B 




on 

4.7 


T 


A * 


T 


6C 


* 


2A 


K 


4B 


M 


6D 


+ 


2B 


L 


4C 


N 


6E 


5 


2C 


M 


4D 


O 


6F 


- 


2D 


N 


4E 


P 


70 




2E 





4F 


Q 


71 


/ 


2F 


P 


50 


R 
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Table B-6. ASR 33 Teletypewriter Character Set (Continued) 

Notes 

Printer: 

1 . BS character (08 16 ) results in a backspace operation. 

2. HI character (09i 6 ) results in printing a space. 

3. LF character (0A 16 ) results in a line feed operation. 

4. CR character (0D 16 ) results in a carriage return operation. 

5. FF character (0C 16 ) results in eight line feed operation. 

6. End-of-record occurs when specified number of characters have been printed. 

7. Maximum buffer size is 72 characters. 

Keyboard: 

1 . BS character (08 1 6 ) is returned to printer as LF and BS. Deletes most recently entered character in buffer. 

2. HT character (09 1 6 ) is returned to printer as space. Character is placed in buffer. 

3. LF character (0D 16 ) is returned to printer as CR, and character is not placed in buffer; terminates the record. 

4. DEL character (7F 16 ) is returned to printer as a line feed and carriage return/Character deletes current input 
record. 

5. Maximum buffer size is 72 characters. 

Paper Tape Punch: 

1 . The end of block character sequence for ASCII is CR (0D J6 ), LF (0A 16 ), DC3 (13 16 ), NULL (00 16 ), Null (00 16 ), 
Null (00 16 ), Null (00 16 ) for Direct is DC3 (13 16 ), Null (00 16 ), Null (00 16 ), Null (00 16 ), Null (00 16 ). The end-of- 
file character sequence for ASCII is DC3 (13 16 ), CR (0D 16 ), LF (0A 16 ), DC3 (13 16 ), Null (00 16 ), Null (00 16 ), 
Null (00 16 ), Null (00 16 ) for Direct is not applicable. 

2. The characters BEL (07 16 ), BS (08 16 ), HT (09 16 ), and FF (0C 16 ) are punched on tape unchanged. 

3. The character CR (0D 16 ) is translated to ETB (17 16 ) and punched. 

4. The character DC3 (13 16 ) may be placed within a record, but may not be the first character of the record other 
than the end-of-file record. 

5. End-of-record occurs when SCB specified number of characters have been punched. 

6. Direct mode punches all characters. If a punch-off is in the buffer, a punch-on is output immediately following 
the character. 

Paper Tape Reader: 

1 . All null characters are ignored at the first of the record and the first nonnull character is the first valid character. 

2. The character BEL (07 16 ), BS (08 16 ), HT (09 16 ) and FF (0C 16 ) are stored in the user's buffer. 

3. The character ETB (17 16 ) is stored in the user's buffer as a CR (0D 16 ). 

4. The character CR (0D 16 ) indicates end-of-record, and is not stored in the buffer. 

5. The character DC3 (13 16 ) as the first character of a record indicates an end-of-file record. The system returns 
end-of-file status after positioning the tape at the beginning of the next record. The DC3 is not stored in the 
buffer. 

6. In direct mode all characters are stored in the buffer until the buffer is full, then the program searches for a DC3 
character to terminate. 
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APPENDIX C 
USER-SUPPLIED MODULES 

C.l INTRODUCTION 

Texas Instruments supplies support modules for a large number of user options in a TX990 
operating system. However, there are some user needs that require modules that are not available, 
which the user must provide. These modules are: 

• DSR (including an interrupt routine) for a unique peripheral device 

• Extended Operation routines for user's extended operations 

• Supervisor call routines for user supervisor calls 

The user-supplied modules execute in the privileged mode in the Model 990/10 Computer, and 
all instructions are available. In the Model 990/4 Computer, all instructions are also available. For 
information on writing each type of routine consult the TX990 System Documentation manual, 
part number 944776-9701. 



NOTE 

When writing modules to be linked with the operating system (i.e., 
DSRs, XOPs, SVCs, user tasks), do NOT use the AORG (absolute 
origin) assembler directive. The TXBOOT program cannot load a 
system with any absolute origins in it. 
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APPENDIX D 
GLOSSARY 

Allocation Unit - A unit of space allocation on the diskette used during file management. An 
allocation unit is equal to six sectors. There are 333 allocation units on a diskette. 

Boot Program — A program that loads the Operating System into memory and starts the Operating 
System executing. 

COMMON — An area of memory which may be coded by use of the system console keyboard (e.g., 
a 733 ASR, a 91 1 VDT, et al) or by means of a task-specified-code and then made accessible 
for use by a task through the Get COMMON Data address supervisor call. The size of the 
system COMMON memory area is determined by a system parameter specified when the 
system is generated. 

Default-substitute — A substitute pathname, or field of a pathname, provided by some utility 
programs when the program or keyboard-entry does not supply the data. 

Device Name Table — A table accessed by the File Management supervisor call to obtain the address 
of the Physical Device Table (PDT) corresponding to a device name. Contains all device names 
defined in the system and addresses of the PDTs for the devices. 

Device Service Routine — A routine of the TX990 Operating System that controls I/O operations 
with a device. 

DNT — Device Name Table. 

DSR — Device Service Routine. 

Dynamic Task Area - The area of memory into which tasks may be loaded and executed. Tasks can 
only be loaded by using the Operator Communication Package (OCP) or the TXDS control 
program. 

End-of-file - A record in a file (either logically or physically) that marks the end of the file. The 
character sequences that denote end-of-file for the file-oriented supported devices are shown in 
Appendix B. 

End-of-record - A character of a record that marks the end of the record. The characters that 
denote end-of-record for supported devices are shown in Appendix B. 

EOF - End-of-file. 

EOR - End-of-record. 

GENTX — The system generation task, which obtains system parameters interactively from the 
keyboard of the system console. GENTX builds source statement files from which modules 
TXDATA and TASKDF are assembled. 

IDT — Program identifier of the source module. 

Initial Program Load — The loading of a TX990 system from disc, cassette, or cards, placing the 
module in memory and starting execution of the system. 
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I/O Supervisor — The portion of TX990 that processes File Management supervisor calls, and passes 
control to the Device Service Routine (DSR) for the device. 

IPL — Initial Program Load. 

Keyboard Status Block (KSB) - A data structure in TXDATA used for character mode I/O with a 
VDT. TXDATA includes a KSB for each VDT. 

KSB - Keyboard Status Block. 

LDT — Logical Device Table. 

Logical Device Table (LDT) - A table in TXDATA that contains a Logical Unit Number (LUNO) 
and the address of the Physical Device Table (PDT) that corresponds to the device assigned to 
the LUNO. 

Logical Unit Number (LUNO) - A number by which an I/O operation specifies the device for the 
operation. 

LUNO — Logical Unit Number. 

OCP — Operator Communication Package , 

Operator Communication Package (OCP) - A package of modules that contains the routines 
for the commands by which the operator or user communicates with TX990. 

PC — Program Counter. 

PDT — Physical Device Table. 

Physical Device Table (PDT) - A table in TXDATA that contains device-related data required by 
the Device Service Routine (DSR) in an I/O supervisor call for the device. 

Program Counter (PC) ■ — A register in the computer hardware that contains the address of the next 
instruction to be executed. 

Stand-alone Program — A program that executes without an operating system. 

Status Register — A register in the computer hardware that contains condition bits and the inter- 
rupt mask. 

Supervisor Call Block — A block of memory that defines a supervisor call, addressed by the XOP 
instruction. The code of the supervisor call is in byte of the supervisor call block. The num- 
ber of additional bytes (if any) and the content of the additional bytes are defined for each 
supervisor call. 

SCB - Supervisor Call Block. 

Supervisor Call Table — A table in TXROOT in which entry points to supervisor call routines are 
listed in a supervisor call code order. 

Task Data Division — One of two logical divisions within a task. The data division contains one or 
more workspaces, data structures, supervisor call blocks, and data for the task. A data division 
may or may not be assembled separately from the procedure division of the task, and is not 
shared with any other task. 
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Task Management - Task Management maintains a state code for each task. The state codes are 
listed in Appendix G. 

Task Scheduler — Initiates execution of a user task (see paragraph 11.2). When the currently 
executing task completes a time slice, the task scheduler passes control to the oldest task on 
the active list for the highest priority (0). If there is no task on the active list for priority 0, 
the oldest task on the active list for the next highest priority receives control. 

Task Status Block (TSB) - A data structure in TXDATA used by the TX990 Operating System to 
control execution of the task. 

Task Time Delay — The result of a task executing a Time Delay supervisor call. The Time Delay 
supervisor call suspends the calling task for a specified number of 50 ms periods. 

Task Time Slice — A period of execution of a task having a maximum length defined when the 
system is generated. A task time slice begins when the task scheduler passes control to the task. 
A task time slice ends: (1) when the system suspends the task upon expiration of the 
maximum time period allowed for a task time slice; (2) when the task executes a supervisor 
call that suspends the task; (3) when the system suspends the task to await completion of an 
I/O operation. To avoid completely locking out low priority tasks, there is a maximum number 
of consecutive time slices (weighting factor) for each priority level. When the number of time 
slices has been used by a priority level, the oldest task on the active list for the next lower 
priority is allowed a time slice before the higher level again has control. The maximum number 
of time slices for each priority level are system parameters defined when the system is 
generated. The maximum period of a time slice may be extended by execution of a Do Not 
Suspend supervisor call. The time slice is less than the maximum time period when the task 
suspends itself, or is suspended awaiting completion of an I/O operation. 

Task Weighting Factor - A count of task time slices for a priority level. When the number of task 
time slices specified as the weighting factor for priority level has been used by tasks at that 
priority level after a task at a lower level has had control, a task at a lower priority level 
receives control for a time slice. 

T n ct a^ Q o riTmot^ir. _ Mpmnn; orP!i whw tasks mav he. loaded and executed (see Dvnamic Task 
Area and Task, Uses, Loading of)- 

Task, Active - A task which is in memory on an active queue, waiting for a time slice. 

Task, Bid - To start execution of a task causing the TX990 Operating System to enter the task on 
the active list according to its priority level. 

Task, Debugging of a — The process of removing errors from a task. 

Task, Diagnostic (DTASK) - A system task that terminates a task when fatal errors occur in the 
task, and prints an error message. 

Task, Executing a — Controlling the processor and the resources of the computer. 

Task, Linked - Consists of separately assembled modules that have been combined by resolving 
external references and definitions in the modules to form a single executable module. 



D-3 Digital Systems Division 




946259-9701 



Task, Loaded - A task copied from an external storage medium into the memory of the computer 
in preparation for execution. 

Tasks, Multiple - Two or more tasks concurrently active in an operating system. 

Task, Procedure Division - One of two logical divisions within a task. The procedure division 
contains the executable code for the task. A procedure division may or may not be assembled 
separately from the data division of the task and may be shared with other tasks. 

Task, Suspended - A task temporarily removed from the active list and from execution as a result 
of a supervisor call or during an I/O operation. 

Task, Terminated - A task removed from execution and from the active list either at normal 
completion or at an abnormal termination initiated by the operator or by the diagnostic task 
when a fatal error is detected. 

Task, Time Delay - A task which has halted execution for a specified length of time, at the end of 
which the task is reactivated. 

Task, User, Loading of - The task loaded into the dynamic task area using the OCP LPROG 
command. 

Task, Waiting - A task waiting for completion of an I/O operation or for a system function or 
resource. 

VOlU be e acce^s e ed" A ^ * ^ CharaCter name ' 0ther than a drive name > h V ^ch a diskette may 

Workspace - A 1 6-word area of memory addressed as workspace registers through 1 5 The active 
workspace is defined by the contents of the workspace pointer register 

Workspace Pointer (WP) - A register that contains the address of workspace register 0. 
Workspace Register - A memory word accessible to an instruction of the computer as a general 
aXTreX" ""* * ""* " " "^ a data «**«. » inLl^tJ^n 
WP - Workspace pointer register. 
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APPENDIX E 
TX990 - DX10 COMPATIBILITY 



E.l INTRODUCTION 

The upward compatibility of the TX990 operating system to DX10 operating system (release series 
3.0 and higher) allows tasks that execute under TX990 to be executed under DX10 when the 

piupci ouiiMuCiauuna aic iii&l. I nib d.piJv^inj.±.A. uvauiUva Lnwbc v^inbujCid.i.jLv/iia- j. nib apuciiuiA aiavj 

compares the supervisor calls of the two systems. The compatibility information cannot be specified 
because of the possible existence of several releases of each system. For information about 
compatibility with a specific release of DX10, the user must study the information about DX10 and 
note the difference. 

E.2 TASK STRUCTURE COMPATIBILITY 

The task structure required for the TX990 operation system is compatible with that of DX10. Tasks 
that execute in the dynamic task area of TX990 and other tasks that consist of a data division and 
procedure division in the same module may be installed as either memory-resident or disc-resident 
tasks under DX10 without modification. Tasks that share a procedure division use the mapping 
capabilities of the Model990/10 Computer when executed under the DX10 operating system. The 
addresses of the procedure division are mapped into the low order addresses of the addressable 
memory, and the addresses of the data division are mapped into the addresses above those of the 
procedure, beginning on a 32-byte boundary. Only the address in the index register used to address 
data is affected by this difference. The task may be relinked to provide this address, or the address 
can be patched. 

E.3 SUPERVISOR CALLS 

The following supervisor calls are available to the TX990 operating system user but are not 
supported by DX10. 

• VDT Utility 

• Make Task Privileged 

• VDT Get Character 

• Get Own ID 

• VDT Conditional Get Character 

• Get System Table 

The following supervisor calls that perform no operational activity in the TX990 operating system 
perform operations in the DX10 operating system as described in the DX10 operating system 
manuals. 

• Return Memory 

• Return Common 
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The End of Program supervisor call performs different operations in the TX990 operating system; 
after terminating the task, it activates the rebid task, which is normally the TX990 Control 
Program. 

The TX990 Operating System task that shares a procedure and contains both a Get Memory and a 
Get Common Data Address supervisor call has an additional restriction under DX10. Memory 
management in DX10 utilizes the mapping capabilities of the computer. The addressable memory 
area of a task consists of three contiguous address segments. The procedure division is mapped into 
the lowest of these address segments, beginning at address zero. The data division is mapped into 
the lowest of these address segments, beginning at address zero. The data division is mapped into 
the next higher segment, leaving one segment for either common memory or a memory block 
obtained with a Get Memory call. A Get Memory call must be followed by a Release Memory call 
before a Get Common Data Address call can be executed. Similarly, a Get Common Data Address 
call must be followed by a Return Common call before a Get Memory call can be executed. The 
address returned by a Get Memory supervisor call or a Get Common Data address is aligned on a 
32-byte boundary in DX 10. 

E.4 FILE MANAGEMENT 

The TX990 Operating System supports two file types, sequential and relative record. Sequential 
files are automatically blocked and blank compressed in the TX990 Operating System while in the 
DX10 Operating System the user optionally controls blocking and blank compression. Only one 
user may access a sequential file at a time; the user's position in the file is maintained across close 
and assign operations while in the DX10 Operating System multiple reads and a single write opera- 
tion may be operating simultaneously, and assign operations cause a rewind operation to occur. The 
file pathname, under a TX990 Operating System assign operation, is compatible with the DX10 
Operating System if the following structure is maintained; device. file name (where device is a 
maximum of 4 characters and file name is a maximum of 6 characters, e.g., DSC.FILMN). The 
'exclusive all' access privilege code on an open service call in the TX990 Operation System is 00 
while in the DX 10 Operating System it is an 01. 
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APPENDIX F 
COMPRESSED OBJECT CODE FORMAT 

The standard object code format under the TX990 Operating System is comprised basically of an ASCII tag character followed by one 
or two ASCII fields. The first field is numeric in value and the optional second field contains a symbol. (For additional familiarity with 
standard object code format, refer to Section 9.5 of the Model 990 Computer Assembly Language Programmer's Guide, part number 
943441-9701.) The first ASCII field in standard object code format is four characters (i.e., four bytes) in length which, when con- 
verted to compressed object code format, is changed to binary, two bytes in length. The second field in standard object code format 
is left unchanged when converting to compressed object code format. Records are terminated with the standard end-of-record tag 
character, only. The beginning-of-module-tag-character is an ASCII zero in standard object code format and a binary one in com- 
pressed object code format. This is used to distinguish between compressed and uncompressed modules. The end-of-module colon 
record, identified by the colon at the beginning of the last line of the module, is unchanged. The diskette is the only device capable 
of supporting compressed object code format. 

ASCII Standard Object Code Format (e.g., from punched cards) 



4*. 

Ct\ 

to 

U\ 

so 

I 

SO 

-Jl 

o 



00008TASK A0000B000AB020000000B00007F7EEF 

: TASK 021/77 12:32:54 



Hexadecimal Representation of Standard Format 



ASCII Representation of Standard Format 
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Hexadecimal Representation of Compressed Format 
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Colon Record for Both Formats Hexadecimal Representation 
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APPENDIX G 
TASK STATE CODES 

The user-task supervisor calls which return one of the task state codes listed in table G-l to byte 1 
of the supervisor call block are: 

• Bid Task Supervisor Call 

• Activate Suspended Task Supervisor Call 

• Activate Time Delay Task Supervisor Call 

The user may code his program to read out the task state code to an output device or, using the 
OCP STate (ST) command, the user can cause a terminal to print out the task state codes. 

Table G-l . List of Task State Codes 

Code 
(Hexadecimal) Significance 

00 Active task, priority level 

01 Active task, priority level 1 

02 Active task, priority level 2 

03 Active task, priority level 3 

04 Terminated task 

05 Task in time delay 

06 Suspended task 

07 Currently executing task 

08 Task awaiting VDT character input 

llQ TocV QTifOi+infT r*r%fYif*1<i+ir*n rvf* T /O 

V^ XUkJl\ U TT Ul t-U^g W111U1V UV/ll V/X -*■/ >-* 

0A Task queued for I/O 

0B Task queued for file utility routine 

0C Task on the diagnostic queue 

0D Task waiting for file management completion 

1 Task queued for file management 
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APPENDIX H 
PRINTOUT OF FATAL TASK ERROR CODES OR DISPLAY OF ILLEGAL INTERRUPT CODE 



The capability of printing out fatal task error codes or displaying an illegal interrupt code is 
available to the user when the Diagnostic Task (DTASK) module is supplied with the TX990 
Operating System. DTASK begins to execute when the TX990 Operating System error logic detects 
a fatal error during task execution; the result of the DTASK module being executed is the printout 
of the fatal task error code or the display of the illegal interrupt code. The fatal task error code is 
printed out on a LUNO, as described below in this appendix, when the task being executed does not 
specify an end action to be executed; the illegal interrupt is displayed on the Programmer Panel. 
When DTASK prints the error message identifying the error, it causes the task to be terminated. The 
fatal errors detected by TX990 are listed in table H-l. 

When TX990 detects that execution of a task has resulted in a fatal error and the task does not 
perform end action, the error logic removes the task in error from the active queue, places it on the 
diagnostic queue, sets the task's state to on diagnostic queue, and executes DTASK. DTASK prints 
an error message on LUNO as shown in the following example: 

*TASK=0F,ERROR=03,ADDRESS-2 1 4E 
WP=2 1 54,PC-28A0,ST=300F 

The example shows that the task having identifier F 16 attempted to access memory address beyond 
the existing ran^e of memor v terror code 3\ The task address is 214E-- ; the current workspace is 
at address 2154 16 ; and the program counter contains 28A0 16 . Since the program counter is ad- 
vanced to the next address before an instruction is executed, the instruction that attempted the 
memory access would be at address 289A 16 , 289C 16 , or 289E 16 , according to the size of the 
instruction. The status register contains 300F 16 . 

After printing the error message, DTASK sets a flag in the Task Status Block (TSB) and places the 
task on the active queue. The flag set by DTASK causes the scheduler to terminate the task. 

In the event that DTASK itself commits a fatal error, it prints the following message on LUNO 0: 

HELP! 

This represents a system error that requires the system to be loaded again. 
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Table H-l . Fatal Task Error Codes and Illegal Interrupt Code 
Error Code Error Description 

1 Memory parity error. Can only occur if the computer is equipped 
with memory parity or error correction hardware. 

2 Illegal operation code. Can only occur in a Model 990/10 Computer. 

3 TILINE* timeout. Nonexistent memory was addressed. Can only 
occur in a Model 990/10 Computer. 

4 Illegal XOP. An XOP instruction having an undefined extended 
operation number or an illegal supervisor call was executed. 

5 Map error. An access outside of the address space defined by the 
current map was attempted. Can occur only in a Model 990/10 
Computer with map option in which the map is enabled. Since 
TX990 does not enable the map, this error could only occur if the 
user task enabled the map. 

6 Privileged operation. A privileged instruction was attempted in the 
nonprivileged mode. Can only occur in a Model 990/10 Computer 
in the nonprivileged mode. 

7 Illegal interrupt. An external interrupt, for which there is no inter- 
rupt routine, has occurred. The user may display the status register 
to determine the interrupt level and must clear the interrupt before 
attempting to resume operation. 

"TILINE is a registered trademark of Texas Instruments Incorporated. 
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I/O ERROR CODES 



Code 




(Hexadecimal) 


Description 




DSR ERRORS 


00 


NO ERROR 


01 


ILLEGAL LUNO 


02 


ILLEGAL OPERATION CODE 


03 


LUNO IS NOT YET OPENED 


04 


RECORD LOST DUE TO POWER FAILURE 


05 


ILLEGAL MEMORY ADDRESS 


06 


TIME OUT, OR ABORT 


07 


READ CHECK ERROR 


11 


DEVICE ERROR 


12 


NO ADDRESS MARK FOUND 


15 


DATA CHECK ERROR 


19 


DISKETTE NOT READY 


1A 


WRITE PROTECT 


IB 


EQUIPMENT CHECK ERROR 




t\t\/at ir» tx> \pv f P crrr"rr»t> 


ID 


SEEK ERROR OR ID NOT FOUND 


IE 


DELETED SECTOR DETECTED 



FILE MANAGEMENT ERRORS 

20 LUNO IS IN USE 

21 BAD DISC NAME 

22 PATHNAME HAS A SYNTAX ERROR 

23 ILLEGAL FUR OPCODE 

24 BAD PARAMETER IN PRB 

25 DISKETTE IS FULL 

26 DUPLICATE FILE NAME 

27 FILE NAME IS UNDEFINED 

28 ILLEGAL LUNO 

29 SYSTEM BUFFER AREA FULL 
2A SYSTEM CAN'T GET MEMORY 
2B FILE MANAGEMENT ERROR 
2C CAN'T RELEASE SYSTEM LUNO 
2D FILE IS PROTECTED 

2E ABNORMAL FUR TERMINATION 

2F FILE UTILITY DOESN'T EXIST IN SYSTEM 

30 NON-EXISTENT RECORD 

3B INVALID ACCESS PRIVILEGE 

3E FILE CONTROL BLOCK ERROR 

3F FILE DIRECTORY FULL 
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I/O ERROR CODES (Continued) 



Code 
(Hexadecimal) Description 

TASK LOADER ERROR 

60 I/O ERROR, LOAD NOT COMPLETE 

6 1 OBJECT MODULE CONTAINS NONRELOC AT ABLE OBJECT CODE 

62 CHECKSUM ERROR LOAD ABORTED 

63 LOADER RAN OUT OF MEMORY 

64 TASK 10 IS BUSY 

65 IMAGE FILE ERROR 

VDT ERRORS 

80 DEVICE NOT AVAILABLE 

VDT STATION NOT FOUND 

Note: 

Error Code >FF is a general error code. 
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APPENDIX J 
SYSTEM TASKS 



J.l INTRODUCTION 

There are eight system tasks in a complete TX990 Operating System: (1) one Operator Communi- 
cation Package (OCP); (2) one Initial Start Task (STASK); (3) one Diagnostic Task (DTASK); 
(4) four File Management Tasks (TXFMP1, TXFMP2, TXFMP3, TXFMP4); (5) one File Utility 
Routine (FUR); (6) one rebid task. The operation of OCP and the supported OCP commands are 
described in Section V. Descriptions of the other system tasks and their operation are included in 
this appendix. 

J.2 INITIAL START TASK (STASK) 

The initial start task (STASK) begins execution at the completion of each IPL to identify the 
revision level of the operating system and to indicate that the IPL has executed successfully. The 
following is an example of the message printed by STASK: 

TX990 SYSTEM Release 2.2 

MEMORY SIZE WORDS: 12288 AVAILABLE: 5940 

The memory size printed is the decimal number of words of memory in the system. The size, in 
words, of the dynamic task area, is printed as the available memory. 

\I/U~~ CTACXf io K-nUaA {Wllmm'nrr TYCMn i"+ ic \nr>n+aA Tt-i +Vie> Hvnamin tdcV cjr£>Q \xrhe>re> it will V»P 
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overlaid by the first user task installed in the dynamic task area. It is assigned task identifier 
10 16 . When it is desired to execute STASK following a manual restart, STASK must be linked 
ahead of TXEND. 

J.3 DIAGNOSTIC TASK (DTASK - TASK ID D 16 ). 

The diagnostic task (DTASK) is executed when TX990 error logic detects a fatal error in a task. 
DTASK prints an error message identifying the error and causes the task to be terminated in error. 
The fatal errors detected by TX990 are listed in Appendix F. 

When TX990 detects that execution of a task has resulted in a fatal error and the task does not 
perform end action, the error logic removes the task in error from the active queue, places it on the 
diagnostic queue, sets the task's state to on diagnostic queue, and executes DTASK. DTASK prints 
an error message on LUNO as shown in the following example: 

*TASK=OF, ERROR=03, ADDRESS=214E 
WP=2154, PC=28A0, ST=300F 

The example shows that the task having identifier F J6 attempted to access a memory address 
beyond the existing range of memory (error code 3). The task address is 214E 16 , the current 
workspace is at address 2154 16 , and the program counter contains 28A0 16 . Since the program 
counter is advanced to the next address before an instruction is executed, the instruction that 
attempted the memory access would be at address 289A J6 , 289C 16 , or 289F 16 , according to the 
size of the instruction. The status register contains 300F 16 . 
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After printing the error message, DTASK sets a flag in the Task Status Block (TSB) and places the 
task on the active ^ueue. The flag set by DTASK causes the scheduler to terminate the task. 

In the event that DTASK itself commits a fatal error, it prints the following message on LUNO 0: 

HELP! 

This represents a system error that requires the system to be loaded again. 

J .4 FILE MANAGEMENT TASKS (TXFMP1, TXFMP2, TXFMP3, TXFMP4 - TASK ID, 

F0 16 ,F1 16 ,F2 16 ,F3 16 ) 

File management must be included in the TX990/TXDS system to enable the user task to com- 
municate with files on the diskette. File management consists of one procedure and a data section 
for each diskette drive included in the system. The four data sections (TXFMP1, TXFMP2, 
TXFMP3 , TXFMP4) when linked with the procedure (TXFMP) define the File Management task 
and must be included in the task definition at system generation time. (See Section 7 entitled 
"System Generation".) If one diskette drive is in the system, TXFMP1 has to be included: if two 
diskette drives are included in the system, both TXFMP 1 and one TXFMP2 must be included: 
etc. The required GENTX parameters for these file management tasks are described in the System 
Task Definition Table. 

J.5 FILE UTILITY TASK (FUR - TASK ID B 16 ) 

The File Utility Routine (FUR) assigns and releases LUNOs to files and performs file maintenance 
functions. 

If the file management task is included in the system, the File Utility task must also be included 
during system generation. The required GENTX parameters for FUR are described in table 7-1 
entitled "System Task Definition". 

J.6 REBIDTASK 

The system rebid task is the task that will be activated whenever an end program supervisor call 
is made. For standard TX990/TXDS systems, the TXDS control program is defined as the rebid 
task, and will be activated when a task terminates with an end program supervisor call, task 
ID 16 16 . The user may wish to designate another task as the rebid task. This may be accomplished 
in the following manner: 

1 . Place the following statements in the new Rebid Task. 

DEF REBID 

REBID EQU ID*>100 

where ID = Task ID of the new Rebid task. 

2. If the TXDS control program is included in the system, link this module before module 
CNTROL. 

J.7 VOLUME NAME SUPPORT (VOLUME - TASK ID C,* ) 

The volume name support task associates a volume name with a diskette drive, allowing files on the 
diskette to be assessed through the volume name as well as the device name. 
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APPENDIX K 
TX990 SYSTEM GENERATION USING DX10 RELEASE 3.0 

GENTX must be installed and executed using the IT and XTS commands on a DX10 system. 
Perform the following steps on a DX10 release 3,0 system: 

1. Place the GENTX object module on a DX10 sequential file or device. If the module is on 
cassette, place it in a cassette drive. If it is on diskette, execute the DX10 conversion 
utility TXDX and convert the object file to a DX10 sequential file. 

2. Install the task, using the IT command: 

II PF = .S$PROGA, TN = GENTX, OBJ = <acnm>, TI = <id> 

where <acnm> is the DX10 access name for the file or cassette unit which contains the 
GNTXDX object module and <id> is the task's ID 

3. Execute the task, using the XTS command: 

XTS TN = GENTX, PF = .S$PROGA 

t. upon initiation oi tue generation proceuure, tue lOnowing message is uispiayeu uy tue 
GENTX task: 

TX990 SYSTEM GENERATION - 945673*C 

5. After the message is displayed, the GENTX program enters the definition phase described 
in paragraphs 7.4.2 through 7.4.10. Refer to this section for a description of the user 
options. 

6. Upon completion of the construction phase the source programs generated for TXDATA 
and TASKDF must be assembled. These source programs may be assembled using 
SDSMAC. The object code files created will be used as input to the linking process in 
step 10. 

7. At this point, the TX990 object modules must be selected from the DSRLIB, OCPLIB, 
FMPLIB and TXLIB cassettes. This selection process is accomplished by use of the 
OBJMGR (Object Manager Task). A file is created as output from OBJMGR and will be 
used as input to the linking process in step 18. 

8. The Link Editor is used to link the object modules of TXDATA, TASKDF, and TX990 
parts created in the above steps. This may be accomplished using the following link 
control file: 



NOSYMT 




PHASE 


0/TX990 


INCLUDE 


name 1 


INCLUDE 


name 2 


INCLUDE 


name 3 


END 
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where 

name 1 is the pathname for TXDATA object file 

name 2 is the pathname for TASKDF object file 

name 3 is the pathname for the selected TX990 parts file. 

The output of SDSLNK may now be copied to cassette or diskette and used on a TX990 
system. 
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APPENDIX L 
SUPPORT FOR THE 5MT/6MT I/O INTERFACE SPECIAL DEVICE 



L.l SYSTEM GENERATION PARAMETERS 

To include a 5MT/6MT Serial I/O Interface Module in a hardware configuration, a new operating 
system must be generated, as described in the section on system generation. During execution of 

vJjjimA. ulc- ^iyj. j. / vjiiMX iliwuu.it- iliubt uc Uciliicu. as a. Special ucvi^C, Iiic i65punscs lO vjiiiN I A. 

prompts are shown in table L-l. Items in all capitals must be entered as shown. 



Table L-l . GENTX Parameters for the 5MT/6MT Modules 



Prompt 

CHASSIS 

DEV NAME 

DEVTYPE 

CRU BASE ADDR 

ACCESS MODE 

INT LEVEL 

or 
INT POSITION 



Response 

Number of the chassis in which the interface 
card is connected (0-7) 

I to 4 character name (e.g. 1056); first 
character must be alphabetic 

SD 

As shown in the chart on top of the chassis 

FILE 

As shown in the chart on top of the chassis 

As connected to the expansion chassis 

Desired number, as described in section 9 

31 

DSR5MT 



TIME-OUT COUNT 

CRU INT LINE 

ENTRY LABEL OF DSR 

ENTRY LABEL OF ROUTINE INTRUP 

INT BRANCH LABEL UNSOL 

EXTENSION DATA carriage return 

L.2 INCLUDING THE DEVICE SERVICE ROUTINE 

When linking the newly generated system, the module DSR5MT in file :DSRLIB/OBJ on the 
TX990 parts diskette must be included. See the paragraph entitled LINKING THE NEW SYSTEM 
in section 9, and the section on the Object Manager, OBJMGR, for details on how to include this 
DSR. 



L-l 
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L.3 FUNCTIONAL DESCRIPTION OF THE 5MT/6MT MODULE 

There are different modes of operation provided by the 5MT/6MT DSR: read status, read-random, 
write-random, read-sequential, and write-sequential mode. Any of the read/write modes may be 
executed in conjunction with a transmit/receive operation using the same supervisor call block 
(SCB), which is described in paragraph L.4. 

All operations possible with the 5MT/6MT interface module can be performed using the SCB and its 
data base. No other control commands are necessary. 

These various modes of operation allow the user to output or retrieve information in single bit 
format (up to 16 bits at a time) or single or multiple word format (up to 16 words at a time), and 
are described in the following paragraphs. 

L.3.1 READ STATUS MODE. The read status mode allows the user to perform a self-test type of 
operation on the interface module. 

When a read status call is made the DSR causes the interface to dump the contents of its output 
RAM into its input RAM and then read the input RAM into a 1 6 word program buffer whose 
address is specified in the SCB. 

Each time a read status call is made the DSR will place several status flags in the 17th word of the 
program buffer. The flag bits have the following significance when set: 

Bit Meaning 



0-8 


Not used 


9 


Self-test enabled 


10-11 


If 00 — transmit/receive mode 




01 — sequential read/ write mode 




1 1 — random read/write mode 


12 


I/F module busy 


13 


Power on (0 = power off) 


14 


I/F interrupt unmasked 


15 


I/F interrupt present 



The usefulness of this call is that the user could output a set of known test data to the output RAM 
and then compare it with the information retrieved from the input buffer to see if the two match. If 
the two sets of data do not match then this indicates the possibility of a hardware problem. 

L.3. 2 READ-RANDOM MODE. The read-random mode retrieves information from the input RAM 
one bit at a time or up to as many as 16 bits at a time, and is performed after any transmit/receive 
cycle. 

The SCB provides an address in the calling program for: storage of the input information; the 
starting address of the input RAM where the information will be taken from; and a bit count 
indicating the number of bits to be input. 

With this operation, the status of a single bit can be tested. 

The information input during a read-random operation is always placed by the DSR in a one-word 
program buffer with the starting RAM bit beginning at the right-most bit position of that word. 
Any bit positions to the left not filled with information will be filled with zeroes. 
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L.3.3 WRITE-RANDOM MODE. The write-random mode outputs information from a buffer to 
the output RAM on the 5MT/6MT serial interface, one bit at a time, or up to 16 bits at a time. 

The information to be output is stored in a calling program buffer whose address is given in the SCB 
of the calling program. The SCB also provides the starting address of a location within the calling 
program buffer. The DSR starts at this location and outputs the number of bits specified in the bit 
count of the SCB, to the 5MT/6MT output RAM. 

With this operation, a single bit can be output at a time. 

The write-random operation is performed before any transmit/receive operation. 

L.3.4 READ-SEQUENTIAL MODE. The read-sequential mode retrieves information from the 
input RAM in the form of 16 bit words. The read-sequential mode can input as many as 16 words 
(256 bits) at a time. 

The SCB provides an address pointing to a buffer in the calling program where the input 
information will be stored; a RAM base address, pointing to one of the 16 words in RAM where the 
information will be taken from; and a count indicating the number of words to be retrieved. 

The read-sequential operation is performed after the transmit/receive operation. 

L.3.5 WRITE-SEQUENTIAL MODE. The write-sequential mode outputs information from a 
buffer to the output RAM of the 5MT/6MT serial interface, in 16 bit word format, and up to as 
many as 16 words at a time. The information to be output is stored in a calling program buffer 
whose address is given in the SCB of the calling program. The SCB also provides the address which 
points to a starting location in tue calling program buffer where the information to be output is 
taken from. The DSR starts at this location and outputs the number of bytes specified in the 
character count of the SCB to the output RAM. 

L.3.6 TRANSMIT/RECEIVE OPERATION. The transmit/receive operation allows the user to 
output all of the information contained in the output RAM to the 5MT/6MT modules while reading 
the present status of the modules into the input RAM of the serial interface. Both operations are 
performed at the same time. 

The transmit/receive (T/R) operation is initiated by clearing a bit in byte 5 of the SCB. 

When the T/R operation is completed an interrupt is generated. The calling task is suspended until 
the interrupt is received unless the initiate bit in byte 4 of the SCB is set. When the initiate bit is set, 
control is returned to the calling task after I/O is initiated. When an interrupt is received the 
information from the 5MT/6MT modules is then present in the input RAM and can be stored in the 
input sotrage buffer. 

The transmit/receive operation precedes the read operations and follows the write operations when 
the T/R bit is set. 

L.4 SUPERVISOR CALL BLOCK FORMAT 

The SCB consists of a 7 word block as shown in figure L-l. The first six words in the block are 
standard for all types of I/O with the exception of byte 5 which contains user set bits peculiar to 
this type of I/O. The remaining word belongs exclusively to this type of I/O. 

Byte contains the supervisor call code (00) for I/O operation. 
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SVC CODE 


STATUS CODE 


2 


I/O OPCODE 


LUNO 


4 


SYSTEM BITS 




T/R 


6 


7 


6 


GENERAL PURPOSE DATA BUFFER ADDRESS 


8 


RECORD LENGTH 


10 


CHARACTER COUNT 


12 


STARTING RAM ADDR 


BIT COUNT 



(A) 137 507 



Figure L-l. 5MT/6MT I/O Call Block 



Byte 1 is the reserved location where the system places a status code after completion of the 
operation. 

There are 4 status codes that may be returned by the system. 

Normal Completion (00) 

Illegal Opertion (02) 

Record Loss Due To Power Failure (04) 

Operation Timed Out Or Terminated Abnormally (06) 

Byte 2 of the SCB contains the user placed I/O opcode indicating which I/O operation will be 
performed. 

The I/O operations are: 

• OPEN (00). The 5MT/6MT serial interface module shall be considered a file oriented 
device, so that an 'OPEN' operation should be performed before proceeding with any 
other operations. The 'OPEN' call returns a status code of 00 in byte 1 of the SCB. 

• CLOSE (01). The 'CLOSE' call ends I/O operation to the device and places a code of 00 
in the status byte of the SCB. 

• READ STATUS (05) 

• READ-SEQUENTIAL (20 16 ) 
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• READ-RANDOM (2 1 16 ) 

• WRITE-SEQUENTIAL (22 16 ) 

• WRITE-RANDOM (23 16 ) 

Byte 3 contains the logical unit number (LUNO). 

Byte 4 contains the system flags, described in detail in section 7. 

Byte 5 contains the transmit/receive (T/R) bit in bit location 5. This bit initiates the 
transmit/receive cycle when reset. The cycle being automatically after a write operation and before 
any read operation. 

Bytes 6-7 General Purpose Data Buffer Address. This location can serve as two different types of 
addresses depending on the type of I/O call being made. 

For a read call the value stored here is the input data buffer address. This address points to the 
location in the calling program where the data to be input from the modules is stored. 

For a write call the value stored here is the output data buffer address. This address points to the 
location in the calling program where the data to be output to the modules is stored. 

Bytes 8-9 Record Length. This location indicates the maximum number of bytes to be transferred 
during a read sequential operation. 

Bytes 10-11 Character Count. The system returns the actual number of bytes transferred during a 
read sequential operation in this location. For a write sequential operation this location contains the 
number of bytes to be output to the module. 

Byte 1 2 Starting Location Address. The value placed in this location applies to both read and write 
operations. 

For vc*c*r\ r\r\e*YCit\r\r\Q thic nrvintc ir\ +Vja ciai-fino- \r\r-of\cw\ in r\y& ir»r>nt T? A A/i wrViorc* flno innnt r\npfotinn 
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is begun. For bit input, the value in this byte ranges from to 255. For words input, the value 
ranges from to 15. During the read operation the DSR looks at the starting location address value, 
goes to that corresponding address on the input RAM and inputs the number of words or bits 
specified by the words/bits count into the calling program buffer. The words or bits are placed in 
the program buffer in locations which correspond to the RAM locations. 

Byte 13 Bit Count. This location is used by random-type I/O only. The value placed here must be 
between and 1 5 and indicates how many bits are to be input or output. A value of indicates that 
16 bits are to be input or output. 
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APPENDIX M 
SUPPORT FOR THE 32-IN/TRANSITION DETECTION MODULE SPECIAL DEVICE 



M.l SYSTEM GENERATION PARAMETERS 

The 32-In/Transition Detection module may be supported as a special device by a customized 
TX990 operating system. To generate a system which includes the module, initiate the system 
generation program GENTX, as described in section 9, During the device definition phase, define 
the module as a special device by responding to the GENTX prompts as shown in table M-l . 

Table Ml. GENTX Parameters for the 32-In/Module 



Prompt 



CHASSIS 



DEV NAME 

DEV TYPE 

CRU BASE ADDR 

ACCESS MODE 

INT LEVEL 

or 
INT POSITION 

TIME-OUT COUNT 

CRU INT LINE 

ENTRY LABEL OF DSR 

ENTRY LABEL OF ROUTINE 

INT BRANCH LABEL 

EXTENSION DATA 



Response 

Number of the chassis to which the module is 
connected (0-7) 

1 to 4 character name (e.g., SD32) 

SD 

As shown in the chart on top of the chassis 

FILE 

As shown in chart on top of main chassis 

As shown in chart on expansion chassis 

Desired number, as described in section 9 

31 

DIGDSR 

INT321 

NONSOL 

carriage return 



M.2 INCLUDING THE DEVICE SERVICE ROUTINE 

When linking the object modules of the new operating system together, the module DIGDSR in file 
:DSRLIB/OBJ on the TX990 parts diskette must be included. 

M.3 SUPERVISOR CALL BLOCK FORMAT 

Figure M-l shows the format of the I/O call block used for all 32-In/Transition module operations. 



M-l 
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00 


STATUS 


2 


I/O OPCODE 


LUNO 


4 


SYSTEM FLAGS 


USER FLAGS 


6 


GENERAL PURPOSE ADDRESS 


8 


RECORD LENGTH 





CHARACTER COUNT 



(A)!37508 

Figure M-l. 32-In/T Call Block Format 

The first three words of the block are standard for all I/O supervisor calls: 

Byte contains the supervisor call code (00) for I/O operation. 

Byte 1 is the reserved location where the system places a status code after completion of the 
operation. 

There are 4 status codes that may be returned by the system: 

00 — Normal Completion 

02 — Illegal Operation Code 

04 — Recorded Loss Due To Power Failure 

06 — Operation Timed Out Or Terminated Abnormally 

Byte 2 of the SCB contains the user placed I/O operation code: 

• OPEN (00) - The 32-In/Transition module is considered a file oriented device; therefore, 
an 'OPEN' operation should be performed before proceeding with any other operations. 
The 'OPEN' returns a status code of in byte 1 of the SVC block. 

• CLOSE (01) - The 'CLOSE' call ends I/O operation to the device and places a code of 
in the status byte of the SVC block. 

• READ 32 BITS ( 20 16 ) - The 'READ 32 BITS' call reads 32 bits of information from 
the module and places it at the location given by the address contained in bytes 6 and 7 
of the SCB. 
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• WRITE MASK ( 22 16 ) - The 'WRITE MASK' call outputs 32 bits of information located 
at the address given in bytes 6 and 7 of the SVC to the module. This data acts as a bit 
level interrupt mask. When a '1' is output to a particular line on the module this enables a 
board level interrupt. The computer however, does not recognize these board level 
interrupts until a 'READ INTERRUPTING BIT' call is executed. This call allows the 
computer to recognize any unmasked board interrupts according to the data in the 
'WRITE MASK' call. 

• READ INTERRUPTING BIT ( 21 16 ) - The 'READ INTERRUPTING BIT' call enabled 
the computer to recognize any board level interrupts set up previously by the 'WRITE 
MASK' I/O call. 

Byte 3 contains the 'LOGICAL UNIT NUMBER' (LUNO). 

Bytes 4 and 5 contain the system flags and user flags described in Section VII. 

Bytes 6 and 7 form a general purpose address which can be used for three separate operations. It 
provides for the (1) address of a two word mask, (2) the adlress of the interrupt data, and (3) the 
address of a two word block of data. These three addresses are described in the following 
paragraphs. 

When used with the 'WRITE MASK' I/O call, bytes 6 and 7 contain the address of a two word mask 
for enabling or disabling module interrupts. Any bits set to a '1' by the two word mask will enable a 
corresponding interrupt on the module. A bit reset to a '0' will prevent an interrupt from occurring. 

When used with a 'READ INTERRUPTING BIT' I/O call the module address of the interrupt data 
is returned by the system at the address given in bytes 6 and 7. The returned module address 
appears in the left-most byte of the word whose address is given in bytes 6 and 7, along with the 
status (1 or 0) of the particular line on the module that caused the interrupt. The configuration of 
the returned module data looks like this: 

BITS 



o-i 


2 


3-7 


8-15 




ST 


MOD ADDR 





(A)1 37509 

When used with a 'READ 32 BITS' I/O call, bytes 6 and 7 contain the address pointing to the 
location where the 32 bits of information are stored after the operation. 

Bytes 8 and 9 contain the maximum number of bytes to be transferred during any operation, 
therefore, a value of 4 must be placed here by the user during all operations. 

Bytes 10 and 11 contain the actual number of bytes transferred by the system. A value of 4 will be 
placed here by the DSR during any operation. 
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ALPHABETICAL INDEX 
INTRODUCTION 

The following index lists key words and concepts from the subject material of the manual 
together with the area(s) in the manual that supply major coverage of the listed concept. The 
numbers along the right side of the listing reference the following manual areas: 

• Sections - References to Sections of the manual appear as "Section x" with the symbol 
x representing any numeric quantity. 

• Appendixes - References to Appendixes of the manual appear as "Appendix y" with the 
symbol y representing any capital letter. 



• 



• 



• 



Paragraphs - References to paragraphs of the manual appear as a series of alphanumeric 
or numeric characters punctuated with decimal points. Only the first character of the 
string may be a letter; all subsequent characters are numbers. The first character refers 
to the section or appendix of the manual in which the paragraph is found. 

Tables - References to tables in the manual are represented by the capital letter T 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the table). The second character is followed by a 
dash (-) and a number: 

Tx-yy 

Figures - References to figures in the manual are represented by the capital letter F 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the figure). The second character is followed by a 
dash (-) and a number: 

Fx-yy 

Other entries in the Index - References to other entries in the index are preceded by 
the word "See" followed by the referenced entry. 
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Abort I/O: 

Supervisor: 

Call 7.6 

Call Block 7.7 

Action, End 5.5 

Activate Suspended Task 

Supervisor Call 6.2.7 

Activate Time Delay Task 

Supervisor Call 6.2.5 

Add Command 3.5.2.5 

All (A) Command 1 1.4 

Allocation Unit 1.3 

Area, Dynamic Task 1 . 1 

Assign Logical Unit Command 3.5.1.1 

Assign LUNO to 

Pathname Operation 7.2.19 

Automatic Overlay Loading 5.2 

Backspace Command 3.5.3.3 

Backup: 

and Initialize Utility Program 10.1 

Error Messages 10.5 

Backward Space Operation 7.2.9 

Bid Task Supervisor Call 6.2. 1 

Binary to Hexadecimal ASCII Supervisor 

Call, Convert 6.3.3 

Blank Compressed 1.3.2 

Block, Supervisor Call 5.6 

Boot Copy (BC) Command 8.5.1 

Bspace Command 3.5.3.3 

Call: 

Abort I/O Supervisor 7.6 

Activate Suspended Task 

Supervisor 6.2.7 

Activate Time Delay Task 

Supervisor 6.2.5 

Bid Task Supervisor 6.2. 1 

Block, Supervisor 5.6 

Change Priority Supervisor 6.2.2 

Convert Binary to Decimal ASCII 

Supervisor 6.3.1 

Convert Binary to Hexadecimal ASCII 

Supervisor 6.3.3 

Convert Decimal ASCII to Binary 

Supervisor 6.3.2 

Convert Hexadecimal ASCII to Binary 

Supervisor 6.3.4 

Date and Time Supervisor 6.6 

Do Not Suspend Supervisor 6.2.3 

End of Program Supervisor 6.2.9 

End of Task Supervisor 6.2.8 

File Utility Supervisor 7.3 

General I/O Supervisor 7.2 

Get Common Data Address 

Supervisor 6.4.4 

Get Data Supervisor 6.5.2 

Get Memory Supervisor 6.4.1 

Get Own ID Supervisor 6.2.11 

Get Parameters Supervisor 6.2.10 

Get System Table Supervisor 6.4.3 

I/O Supervisor 7.2 

Make Task Privileged Supervisor . . . 6.2.12 



Put Data Supervisor 6.5.1 

Release Memory Supervisor 6.4.2 

Return Common Data Supervisor . . . 6.4.5 

Time Delay Supervisor 6.2.4 

Unconditional Wait Supervisor 6.2.6 

VDT: 

Character Input Supervisor 7.4.2 

Conditional Character Input 

Supervisor 7.4.3 

Utility Supervisor 7.4.1 

Wait for I/O Supervisor 7.5 

Calls: 

I/O Supervisor . . Section VII 

Supervisor 1.1, TA-1 

Change: 
File Name: 

(CN) Command 8.5.6 

Operation 7.2.23 

Priority Supervisor Call .......... 6.2.2 

Protection (CP) Command . . 8.5.7 

Character Mode 1.4.2 

Clear Breakpoint Command 3.5.2.4 

Close: 

Operation 7.2.3 

Unload Operation 7.2.6 

With EOF Operation . . . . 7.2.4 

Code, Illegal Interrupt TH-1 

Code Numbers: 

Device T7-3 

File T7-3 

Codes: 

Fatal Task Error TH-1 

I/O Error Appendix I 

Task State Appendix G 

Command: 

Add 3.5.2.5 

All (A) 11.4 

Assign Logical Unit 3.5.1.1 

Backspace 3.5.3.3 

Boot Copy (BC) 8.5.1 

Change: 

File Name (CN) 8.5.6 

Protection (CP) 8.5.7 

Clear Breakpoint 3.5.2.4 

Compress File (CM) 8.5.5 

Copy(C) 11.4 

Define Output (DO) 8.5.8 

Delete: 

File (DF) 8.5.4 

Procedure 3.5.1.8 

Task 3.5.1.7 

Diskette: 

Dump(DD) 8.5.11 

Load(DL) 8.5.12 

Done(D) 11.4 

Dump: 

Memory 3.5.2.1 

Workspace 3.5.2.8 

Execute Task 3.5.1.4 

File: 

Dump(FD) 8.5.13 

Load(FL) 8.5.14 
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Command: (Continued) 

Format 3 4 

SYSUTL 8.4 

Forward Space 3.5.3.2 

Initialize Date and Time 3.5.4.1 

(ID) 8.5.15 

Insert (I) 1 1.4 

Install Procedure 3.5.1.6 

Install Task 3.5.1.5 

Jump Instruction 3.5.2.7 

Kill I/O Operation 3.5.2.10 

Kill Task 3.5.2.9 

Load: 

Memory 3.5.2.2 

Program 3.5.1.3 

Map: 

Diskette 8.5.9 

File(MF) 8.5.10 

Print Time and Date 3.5.4.2 

(TI) 8.5.16 

Procedure Status 3.5.3.6 

Release Logical Unit 3.5.1.2 

Replace (R) 11.4 

Rewind Device 3.5.3.1 

Set: 

Breakpoint 3.5.2.3 

System File (SF) 8.5.2 

Skip(S) 11.4 

Status of I/O 3.5.3.5 

Subtract 3.5.2.6 

Task Status 3.5.3.4 

Terminate 3.5.5 

SYSUTL (TE) 8.5.17 

Time . 3.5.4.2 

Trace 3.5.2.11 

Commands: 

OCP 3.5 

Task Support 3.5.1 

SYSUTL 8.1 

Common Memory 4.5 

Communication Package (OCP), 

Operator Section III 

Compress File: 

(CM) Command 8.5.5 

Operation 7.2.22 

Construction Phase 9.3.4 

Control: 

Program 1 .6, 4. 1 

Error Messages T4-2 

CONTROL/OBJ 9.5 

Convert: 

Binary to Decimal ASCII 

Supervisor Call 6.3.1 

Binary to Hexadecimal ASCII 

Supervisor Call 6.3.3 

Decimal ASCII to Binary 

Supervisor Call 6.3.2 

Hexadecimal ASCII to Binary 

Supervisor Call 6.3.4 

Copy (C) Command 1 1.4 

Create File Operation 7.2.18 

Data Division 5.1.3 

Date and Time Supervisor Call 6.6 



Decrement Sector Number (D) 

Directive 13.4.2 

Default Values 4.4.2 

Define Output (DO) Command 8.5.8 

Definition Phase 9.3.3 

Delete File: 

(DF) Command 8.5.4 

Operation 7.2.20 

Delete: 

Procedure Command 3.5.1.8 

Protect File Operation 7.2.26 

Task Command . . , , , 3.5.1.7 

Device: 

Code Numbers T7-3 

Keywords, GENTX T9-3 

Name 1.4.1 

Table, Physical C.2 

Directive: 

Decrement Sector Number (D) .... 13.4.2 

Increment Sector Number (I) 13.4.1 

Modify Displayed Sector Data (M) . . 13.4.7 

Print Display (P) 13.4.3 

Set Data Mode to ASCII (A) 13.4.4 

Set Data Mode to EBCDIC (E) .... 13.4.5 
Set Data Mode to 

Hexadecimal (H) 13.4.6 

Directives, Diskette Dump Utility .... T13-1 

Directory 1.3 

Diskette Dump (DD) Command 8.5.11 

Diskette: 
Dump: 

(ucjNumrj uiiniy 

Program Section XIII 

Utility Directives T13-1 

Diskette Load (DL) Command 8.5.12 

Division: 

Data 5.1.3 

Procedure 5.1.3 

Do Not Suspend Supervisor Call 6.2.3 

Done (D) Command 1 1.4 

DSKDMP Error Messages 13.5 

DSR C.2 

DSRLIB/OBJ 9.5 

Dump (DSKDMP) Utility 

Program, Diskette Section XIII 

Dump Memory Command 3.5.2.1 

Dump Utility Directives, Diskette .... T13-1 

Dump Workspace Command 3.5.2.8 

Dynamic: 

Task Area 1.1 

Tasks 1.1 

DYNTSK/OBJ 9.5 

End Action 5.5 

End of Program Supervisor Call 6.2.9 

End of Task Supervisor Call 6.2.8 

Error: 
Codes: 

Fatal Task TH-1 

I/O Appendix I 

Error Messages: 

BACKUP 10.5 

Control Program T4-2 
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Error Messages: (Continued) 

DSKDMP 13.5 

GENTX T9-6 

LIST80/80 12.1.2 

OBJMGR Tll-1 

OCP T3-2 

General T3-2 

Operand 3-3 

SYSUTL T8-1 

Execute: 

Commands 3.5.1.4 

Task Command 3.5.1.4 

Extended Operation Routines C.3 

Extension • 1-4.1 

Fatal Task Error Codes TH-1 

Features, File Management 1.3 

File: 

Code Numbers T7-3 

Dump (FD) Command 8.5.13 

Load (FL) Command 8.5.14 

Management Features 1.3 

Management Tasks J.4 

Mode 1.4.2 

Name 1.4.1 

System 10.4 

Utility Supervisor Call 7.3 

Utility Task J.5 

Files: 

Program 1.3.4 

Relative Record 1.3.3 

Sequential 1.3.2 

FMPLIB/OBJ 9.5 

Format: 

Command 3.4 

SYSUTL Command 8.4 

Forward Space: 

Command 3.5.3.2 

Operation 7.2.8 

General Error Messages, OCP T3-2 

General I/O Supervisor Call 7.2 

Generation, System Section IX 

GENTX: 

Device Keywords T9-3 

Error Messages T9-6 

Prompts T9-1 

Utility Program 9.1 

Get: 

Common Data Address 

Supervisor Call 6.4.4 

Data Supervisor Call 6.5.2 

Memory Supervisor Call 6.4.1 

Own ID Supervisor Call 6.2.1 1 

Parameters Supervisor Call 6.2.10 

System Table Supervisor Call 6.4.3 

Hexadecimal ASCII to Binary Supervisor 

Call, Convert 6.3.4 

I/O: 

Error Codes Appendix I 

Logical 1.4 

Mode 1.4.2 



Operations 7.2.1 

Supervisor: 

Call 7.2 

Calls Section VII 

Illegal Interrupt Code TH-I 

Increment Section Number 

(I) Directive 13.4.1 

Initialize Date and Time: 

(ID) Command 8.5.15 

Command 3.5.4.1 

Initialize Utility Program, Backup and . . 10.1 

INPUT: Prompt 4.4.1.2 

Insert (I) Command 11.4 

Install Procedure Command 3.5.1.6 

Install Task Command 3.5.1.5 

Interfaces, Operator 1.6 

Interrupt Code, Illegal . TH-1 

Interrupt Handler 1.1 

Load Memory Command 3.5.2.2 

Load Program Command 3.5.1.3 

Loading: 

Automatic Overlay 5.2 

the Operating System Section II 

Logical I/O 1.4 

LUNOs 1.4 

Make Task Privileged 

Supervisor Call 6.2.12 

Management Features, File 1.3 

Map Diskette Command 8.5.9 

Map File (MF) Command 8.5.10 

Memory, Common 4.5 

Messages, SYSUTL Error T8-1 

Mode: 

Character 1.4.2 

File 1.4.2 

I/O 1.4.2 

Read Status L.3.1 

Read-Random L.3.2 

Read-Sequential L.3.4 

Record 1.4.2 

Write-Random L.3.3 

Write-Sequential L.3.5 

Modify Displayed Sector Data 

(M) Directive 13.4.7 

Modules, User-Supplied Appendix C 

Name: 

Device 1.4.1 

File 1.4.1 

Name Support Task, Volume J. 7 

Names, Volume 1.3.1 

Object Manager (OBJMGR) Utility 

Program Section XI 

OBJMGR Error Messages Tll-1 

OCP: 

Commands 3.5 

Error Messages T3-2 

General Error Messages T3-2 

Operand Error Messages . T3-3 

Task Support Commands 3.5.1 

OCPLIB/OBJ 9.5 
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Open Operation 7.2.2 

Open Rewind Operation 7.2.5 

Operand Error Messages, OCP T3-3 

Operating System T9-7 

Loading the Section II 

Operation: 

Assign LUNO to Pathname 7.2.19 

Backward Space 7.2.9 

Change File Name 7.2.23 

Close 7.2.3 

Close Unload 7.2.6 

Close with EOF 7.2.4 

Compress File 7.2.22 

Create File 7.2.18 

Delete File 7.2.20 

Delete Protect File 7.2.26 

Forward Space 7.2.8 

Open 7.2.2 

Open Rewind 7.2.5 

Read ASCII 7.2.10 

Read Device File Status 7.2.7 

Read Direct 7.2.1 1 

Release LUNO Assignment 7.2.21 

Rewind 7.2.15 

Transmit/ Receive L.3.6 

Unload 7.2.16 

Unlock 7.2.17 

Unprotect File 7.2.24 

Verify Pathname Syntax 7.2.27 

Write ASCII 7.2.12 

Write Direct 7.2.13 

Write EOF 7.2.14 

Write Protect File 7.2.25 

Operations, I/O 7.2.1 

Operator: 

Communication Package 

(OCP) Section III 

Interfaces 1.6 

OPTIONS: Prompt 4.4.1.4 

OUTPUT: Prompt 4.4.1.3 

v/yviioJ i_iuaumg, nuiuiuauv. J.z. 

Overlays 5.2 

Parameters, System Timing T9-2 

Pathnames 1.4.1 

PDT C.2 

Phase: 

Construction 9.3.4 

Definition 9.3.3 

Physical Device Table C.2 

Print Display (P) Directive 13.4.3 

Print Time and Date: 

(TI) Command 8.5.16 

Command 3.5.4.2 

Procedure Division 5.1.3 

Procedure Status Command 3.5.3.6 

Program: 

Backup and Initialize Utility 10.1 

Control 1.6, 4.1 

Diskette Dump (DSKDMP) 

Utility Section XIII 

Error Messages, Control T4-2 

Files 1.3.4 



GENTX Utility 9 1 

LIST80/80(LIST80) 

Utility Section XII 

Object Manager (OBJMGR) 

Utility Section XI 

System Utility Section VIII 

Program: Prompt 4.4.1.1 

Programming Tasks Section V 

Prompt: 

Input: , 4.4.1.2 

Options: 4.4.1.4 

Output: \ 4.4.1.3 

Program: 4.4.1.1 

Prompts, GENTX T9-1 

Put Data Supervisor Call 6.5.1 

Read ASCII Operation 7.2.10 

Read Device File Status Operation .... 7.2.7 

Read Direct Operation 7.2. 1 1 

Read Status Mode L.3.1 

Read-Random Mode L.3.2 

Read-Sequential Mode L.3.4 

Rebid Task J.6 

Record Mode 1.4.2 

Rewind Operation 7.2.15 

Routines: 

Extended Operation C.3 

User-Supplied Supervisor Call C.4 

Scheduler Task 1.1, 5.3 

Sequential Files 1.3.2 

Set: 

Breakpoint Command 3.5.2.3 

Data Mode to ASCII 

(A) Directive 13.4.4 

Set Data Mode to EBCDIC 

(E) Directive 13.4.5 

Set Data Mode to Hexadecimal 

(H) Directive 13.4.6 

Set System File (SF) Command 8.5.2 

Qlrin fQI C^nrnmnnA 1 1 A 

<-Ji*.xy V>-»/ v/umuiuiiu u.n 

Slice, Time 5.3 

State Codes, Task Appendix G 

Status of I/O Command 3.5.3.5 

Sub Commands 3.5.2.6 

Subfiles 1.3.2.1 

Subtract Command 3.5.2.6 

Supervisor: 
Call: 

Abort I/O 7.6 

Activate Suspended Task 6.2.7 

Activate Time Delay Task 6.2.5 

Bid Task 6.2.1 

BL, Abort I/O 7.7 

Block 5.6 

Change Priority 6.2.2 

Convert: 

Binary to Decimal ASCII 6.3.1 

Binary to Hexadecimal ASCII . . 6.3.3 

Decimal ASCII to Binary 6.3.2 

Convert Hexadecimal ASCII 

to Binary 6.3.4 
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Supervisor: (Continued) 

Date and Time 6.6 

Do Not Suspend 6.2.3 

End of Program 6.2.9 

End of Task 6.2.8 

File Utility 7.3 

General I/O 7.2 

Get: 

Common Data Address 6.4.4 

Data 6.5.2 

Memory 6.4.1 

Own ID 6.2.11 

Parameters 6.2.10 

System Table 6.4.3 

I/O 7.2 

Make Task Privileged 6.2.12 

Put Data 6.5.1 

Release Memory 6.4.2 

Return Common Data . 6.4.5 

Routines, User-Supplied C.4 

Time Delay 6.2.4 

Unconditional Unit 6.2.6 

VDT: 

Character Input 7.4.2 

Conditional Character Input . . . 7.4.3 

Utility 7.4.1 

Wait for I/O 7.5 

Calls 1.1,TA-1 

I/O Section VII 

System: 

File 10.4 

Generation Section IX 

Tasks Appendix J 

Timing Parameters T9-2 

Utility Program Section VIII 

SYSUTL 8.1 

(TE) Command, Terminate 8.5.17 

Command Format 8.4 

Commands 8.1 

Error Messages T8-1 

Table, Physical Device C.2 

Task: 

Area, Dynamic 1.1 

Error Codes, Fatal TH-1 

File Utility J.5 

Rebid J.6 

Scheduler 1.1, 5.3 

State Codes Appendix G 

Task: 

Status Command 3.5.3.4 

Support Commands, OCP 3.5.1 

Volume Name Support J. 7 

TASKDF 9.1 

Tasks 1.1 

Dynamic 1.1 

File Management J.4 

Programming Section V 

System Appendix J 



Terminate: 

Command 3.5.5 

SYSUTL (TE) Command 8.5.17 

The Operating System, Loading . . . Section II 

Time: 

Command 3.5.4.2 

Delay Supervisor Call 6.2.4 

Slice 1.1,5.3 

Timing Parameters, System T9-2 

Trace: 

Command 3.5.2.11 

Transmit/ Receive Operation . L.3.6 

TXLIB/OBJ 9.5 

TXDATA 9.1 

Unconditional Wait Supervisor Call .... 6.2.6 

Unit, Allocation 1.3 

Unload Operation 7.2.16 

Unlock Operation 7.2.17 

Unprotect File Operation 7.2.24 

User-Supplied: 

Modules . . Appendix C 

Supervisor Call Routines C.4 

Utility: 

Directives, Diskette Dump T13-1 

Program: 

Backup and Initialize . 10.1 

Diskette Dump 

(DSKDMP) Section XIII 

GENTX 9.1 

LIST80/80 (LIST80) ..... Section XII 
Object Manager 

(OBJMGR) Section XI 

System Section VIII 

Supervisor Call, File 7.3 

Values, Default 4.4.2 

VDT: 

Character Input Supervisor Call ..... 7.4.2 
Conditional Character Input 

Supervisor Call . 7.4.3 

Utility Supervisor Call . . . 7.4.1 

Verify Pathname Syntax Operation . . . 7.2.27 
Volume: 

Name Support Task J. 7 

Names 1.3.1 

Wait for I/O Supervisor Call 7.5 

Write: 

ASCII Operation 7.2.12 

Direct Operation 7.2.13 

EOF Operation 7.2.14 

Protect File Operation . 7.2.25 

Random Mode L.3.3 

Sequential Mode L.3.5 
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